Nos complace anunciar GroupDocs.Conversion for .NET 25.10, disponible a partir de octubre 2025.
Esta versión menor incorpora un conjunto de mejoras de diseño de página, nuevas capacidades de opciones de carga y una serie de correcciones críticas de errores. El cambio más visible es una refactorización de la API pública que agrupa la configuración de márgenes y tamaño en objetos dedicados, mejorando la consistencia en todas las opciones de conversión.

Novedades en esta versión

ID Funcionalidad
CONVERSIONNET‑8032 Añade soporte para establecer tamaño de página, márgenes y orientación en EmailLoadOptions antes de la conversión.
CONVERSIONNET‑8013 Añade soporte para establecer márgenes de página en SpreadsheetOptions antes de la conversión.
CONVERSIONNET‑8012 Añade soporte para establecer tamaño de página en SpreadsheetOptions antes de la conversión.
CONVERSIONNET‑8009 Añade soporte para establecer tamaño de página en TxtLoadOptions y WordProcessingLoadOptions antes de la conversión.
CONVERSIONNET‑8008 Añade soporte para establecer márgenes de página en TxtLoadOptions y WordProcessingLoadOptions antes de la conversión.

Estas incorporaciones le permiten afinar el diseño del documento fuente antes del paso de conversión, dándole un control más preciso sobre la apariencia de los archivos resultantes.

Refactorización de la API – Configuraciones de Diseño de Página (Cambios Breaking)

⚠️ CAMBIO BREAKING (vigente v26.1) – Veinte propiedades individuales de margen/tamaño están en desuso y se eliminarán en la próxima versión mayor.
El nuevo modelo introduce dos objetos auxiliares que sustituyen a las antiguas propiedades escalares:

Clase afectada Propiedades obsoletas Reemplazo
PdfConvertOptions (7) MarginTop, MarginBottom, MarginLeft, MarginRight → MarginSettingsPageSize, PageWidth, PageHeight → SizeSettings MarginSettings (PageMarginOptions), SizeSettings (PageSizeOptions)
WordProcessingConvertOptions (7) Igual que PDF Igual que PDF
EBookConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings
CadConvertOptions (3) PageSize, PageWidth, PageHeight → SizeSettings SizeSettings

Nuevas clases auxiliares

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
}

Guía de migración

Migración de márgenes de página

Enfoque antiguo (obsoleto)

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

Enfoque nuevo (recomendado)

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

Migración de la configuración de tamaño de página

Enfoque antiguo (obsoleto)

// 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)
};

Enfoque nuevo (recomendado)

// 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
    }
};

Adoptar los nuevos objetos elimina ambigüedades (la API anterior combinaba puntos y píxeles) y alinea todas las opciones de conversión bajo un modelo común y fácil de descubrir.

Correcciones y mejoras

ID Tipo de problema Descripción
CONVERSIONNET‑8031 Error PreserveOriginalDate configurado como false se ignoraba previamente en .NET.
CONVERSIONNET‑8023 Error Las conversiones con sintaxis fluent fallaban cuando no se suministraban opciones de conversión explícitas.
CONVERSIONNET‑8020 Error La conversión de WordProcessing lanzaba una excepción no controlada por falta de Microsoft.Extensions.DependencyInjection (v8.0.0.0).
CONVERSIONNET‑8006 Error WordProcessingConvertOptions trataba PageWidth/PageHeight como píxeles en lugar de puntos.
CONVERSIONNET‑8005 Error Las propiedades PdfConvertOptions.Margin* no se respetaban durante la conversión a PDF.

Estas correcciones aumentan la fiabilidad en los escenarios de conversión más habituales y alinean la biblioteca con el comportamiento esperado en .NET.

Cómo obtener la actualización

  • NuGet – Actualice al último paquete GroupDocs.Conversion:

    dotnet add package GroupDocs.Conversion --version 25.10

    (El mismo paquete funciona para .NET 6+, .NET Framework 4.6.2 y .NET Core.)

  • Descarga directa – Los ensamblados para .NET y .NET Framework están disponibles en la página de la versión:
    https://releases.groupdocs.com/conversion/net/25-10/

Recursos