GroupDocs.Conversion pour .NET 25.10 – Points forts de la version d’octobre 2025

Nous sommes heureux d’annoncer GroupDocs.Conversion for .NET 25.10, disponible depuis octobre 2025.
Cette version mineure apporte un ensemble d’améliorations de mise en page, de nouvelles capacités d’options de chargement et plusieurs corrections de bugs critiques. Le changement le plus visible est une refactorisation de l’API publique qui regroupe les paramètres de marge et de taille dans des objets dédiés, améliorant la cohérence de toutes les options de conversion.

Nouveautés de cette version

Ces ajouts vous permettent d’ajuster finement la mise en page du document source avant l’étape de conversion, vous offrant un contrôle plus précis sur l’apparence des fichiers résultants.

Refactorisation de l’API – Paramètres de mise en page (Modifications incompatibles)

⚠️ CHANGEMENT INCOMPATIBLE (effectif v26.1) – Vingt propriétés individuelles de marge/taille sont obsolètes et seront supprimées dans la prochaine version majeure.
Le nouveau modèle introduit deux objets d’assistance qui remplacent les anciennes propriétés scalaires :

Nouvelles classes d’assistance

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; }   // La définition de cette valeur force PageSize = PageSize.Custom
    public float PageHeight { get; set; }  // La définition de cette valeur force PageSize = PageSize.Custom
}

Guide de migration

Migration des marges de page

Ancienne approche (obsolète)

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

Nouvelle approche (recommandée)

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

Migration des paramètres de taille de page

Ancienne approche (obsolète)

// Taille prédéfinie
var pdfOptions = new PdfConvertOptions
{
    PageSize = PageSize.A4
};

// Dimensions personnalisées
var wpOptions = new WordProcessingConvertOptions
{
    PageWidth  = 612, // points (largeur Letter)
    PageHeight = 792  // points (hauteur Letter)
};

Nouvelle approche (recommandée)

// Taille prédéfinie
var pdfOptions = new PdfConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageSize = PageSize.A4
    }
};

// Dimensions personnalisées
var wpOptions = new WordProcessingConvertOptions
{
    SizeSettings = new PageSizeOptions
    {
        PageWidth  = 612,   // points
        PageHeight = 792    // points
        // PageSize devient automatiquement PageSize.Custom
    }
};

L’adoption des nouveaux objets élimine les ambiguïtés (l’ancienne API mélangeait points et pixels) et aligne toutes les options de conversion sous un modèle commun et facilement découvrable.

Correctifs et améliorations

Ces correctifs renforcent la fiabilité des scénarios de conversion les plus courants et alignent la bibliothèque sur le comportement attendu de .NET.

Comment obtenir la mise à jour

• NuGet – Mettez à jour vers le dernier package GroupDocs.Conversion :

  dotnet add package GroupDocs.Conversion --version 25.10
  

  (Le même package fonctionne pour .NET 6+, .NET Framework 4.6.2 et .NET Core.)

• Téléchargement direct – Les assemblages pour .NET et .NET Framework sont disponibles sur la page de version :
  https://releases.groupdocs.com/conversion/net/25-10/

Ressources

• Notes de version complètes – (lien vers la page officielle des notes de version, si disponible)
• Documentation – https://docs.groupdocs.com/conversion/net/
• Forum de support – https://forum.groupdocs.com/c/conversion/12