We’re happy to announce GroupDocs.Conversion for .NET 25.10, available as of October 2025.
This minor release brings a set of page‑layout enhancements, new load‑option capabilities, and a handful of critical bug fixes. The most visible change is a public API refactor that groups margin and size settings into dedicated objects, improving consistency across all conversion options.

מה חדש במהדורה זו

ID תכונה
CONVERSIONNET‑8032 הוספת תמיכה בהגדרת גודל העמוד, שוליים וכיווניות ב‑EmailLoadOptions לפני ההמרה.
CONVERSIONNET‑8013 הוספת תמיכה בהגדרת שוליי עמוד ב‑SpreadsheetOptions לפני ההמרה.
CONVERSIONNET‑8012 הוספת תמיכה בהגדרת גודל עמוד ב‑SpreadsheetOptions לפני ההמרה.
CONVERSIONNET‑8009 הוספת תמיכה בהגדרת גודל עמוד ב‑TxtLoadOptions וב‑WordProcessingLoadOptions לפני ההמרה.
CONVERSIONNET‑8008 הוספת תמיכה בהגדרת שוליי עמוד ב‑TxtLoadOptions וב‑WordProcessingLoadOptions לפני ההמרה.

These additions let you fine‑tune the layout of the source document before the conversion step, giving you tighter control over the appearance of the resulting files.

שינויים במבנה ה‑API – הגדרות פריסת עמוד (שינויים משבשים)

⚠️ שינוי משבש (מתקיים החל מ‑v26.1) – עשרים מאפייני margin/size בודדים נחשבים ליעלים ותוסרנה בגירסה הגדולה הבאה.
המודל החדש מציג שני אובייקטים מסייעים שמחליפים את המאפיינים הסקלריים הישנים:

מחלקה מושפעת מאפיינים מיושנים החלפה
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) זהה ל‑PDF זהה ל‑PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

מחלקות מסייעות חדשות

public class PageMarginOptions
{
    public float? Top { get; set; }
    public float? Bottom { get; set; }
    public float? Left { get; set; }
    public float? Right { get; set; }
}

public sealed class PageSizeOptions
{
    public PageSize PageSize { get; set; }
    public float PageWidth { get; set; }   // Setting this forces PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // Setting this forces PageSize = PageSize.Custom
}

מדריך מעבר

מעבר לשוליי עמוד

גישה ישנה (מיושנת)

var options = new PdfConvertOptions
{
    MarginTop    = 10,
    MarginBottom = 10,
    MarginLeft   = 20,
    MarginRight  = 20
};

גישה חדשה (מומלצת)

var options = new PdfConvertOptions
{
    MarginSettings = new PageMarginOptions
    {
        Top    = 10,
        Bottom = 10,
        Left   = 20,
        Right  = 20
    }
};

מעבר להגדרות גודל עמוד

גישה ישנה (מיושנת)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    PageSize = PageSize.A4
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    PageWidth  = 612, // points (Letter width)
    PageHeight = 792  // points (Letter height)
};

גישה חדשה (מומלצת)

// Predefined size
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// Custom dimensions
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // points
        PageHeight = 792    // points
        // PageSize automatically becomes PageSize.Custom
    }
};

Adopting the new objects eliminates ambiguity (the previous API mixed points and pixels) and aligns all conversion options under a common, discoverable model.

תיקונים ושדרורים

ID סוג בעייה תיאור
CONVERSIONNET‑8031 באג PreserveOriginalDate שהוגדר ל‑false היה בהתעלמות קודמת ב‑.NET.
CONVERSIONNET‑8023 באג המרות תחביר Fluent‑syntax נכשלו כאשר לא סופק אובייקט אפשרויות המרה מפורש.
CONVERSIONNET‑8020 באג המרת WordProcessing גרמה לחריגה בלתי מטופלת עקב העדר Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 באג WordProcessingConvertOptions טיפל ב‑PageWidth/PageHeight כפיקסלים במקום כנקודות.
CONVERSIONNET‑8005 באג מאפייני PdfConvertOptions.Margin* לא נחשבו במהלך המרת PDF.

These fixes tighten reliability across the most common conversion scenarios and bring the library in line with expected .NET behavior.

איך לקבל את העדכון

  • NuGet – שדרוג לחבילה האחרונה של GroupDocs.Conversion:

    dotnet add package GroupDocs.Conversion --version 25.10

    (החבילה הפעילה מתאימה ל‑.NET 6+, .NET Framework 4.6.2, ול‑.NET Core.)

  • הורדה ישירה – קבצי Assembly ל‑.NET ול‑.NET Framework זמינים בדף השחרור:
    https://releases.groupdocs.com/conversion/net/25-10/

משאבים