We’re happy to announce GroupDocs.Assembly for .NET 25.12 – the Christmas release that’s available as of December 2025. This update adds full OOXML compliance handling, improves barcode generation on Linux, and resolves critical template‑processing issues.

Bu sürümde yenilikler

Kategori Sorun Özet
Özellik ASSEMBLYNET‑70 Word belgeleri için açık OOXML uyumluluk spesifikasyonu uygulayın.
Geliştirme ASSEMBLYNET‑68 Word belgeleri için OOXML uyumluluk desteği ekleyin (Ecma, Transitional, Strict).
Geliştirme ASSEMBLYNET‑69 Mümkün olduğunda orijinal belgenin uyumluluk seviyesini otomatik olarak koruyun.
Geliştirme ASSEMBLYNET‑75 Codabar barkodları için minimum X‑boyutunu zorunlu kılın (daha güvenilir üretim).
Geliştirme ASSEMBLYNET‑76 Linux’ta barkod üretimi sırasında şeffaf renklerin kullanılmasını önleyin.
Düzeltme ASSEMBLYNET‑73 SdtRun içindeki satır içi içerik denetimlerinde şablon ifadeleri artık doğru işleniyor.
Düzeltme ASSEMBLYNET‑60 Barkodlar Linux (.NET 8) derlemelerinde artık boş render edilmiyor.

OOXML Uyumluluk Desteği

Artık bir Word belgesini (DOCX, DOCM, DOTX, vb.) kaydederken tam OOXML uyumluluk seviyesini seçebilirsiniz. Kütüphane ayrıca orijinal belge Transitional olduğunda kaynak belgenin uyumluluğunu otomatik olarak korur.

Yeni genel numaralandırma: OoxmlCompliance

namespace GroupDocs.Assembly
{
    /// <summary>
    /// Specifies the OOXML compliance level to use when saving Word documents to OOXML formats.
    /// </summary>
    public enum OoxmlCompliance
    {
        /// <summary>ECMA‑376 compliance.</summary>
        Ecma,

        /// <summary>ISO/IEC 29500:2008 Transitional compliance.</summary>
        Transitional,

        /// <summary>ISO/IEC 29500:2008 Strict compliance.</summary>
        Strict
    }
}

LoadSaveOptions içinde yeni özellik: OoxmlCompliance

public class LoadSaveOptions
{
    /// <summary>
    /// Gets or sets the OOXML compliance level to use when saving Word documents to OOXML formats.
    /// The default value is null, which means the compliance level will be determined automatically.
    /// </summary>
    public OoxmlCompliance? OoxmlCompliance { get; set; }
}

Açık bir OOXML uyumluluk seviyesini nasıl belirtirsiniz

var source = "template.docx";
var target = "output.docx";
var data   = "data.json";

// Create LoadSaveOptions with explicit OOXML compliance
var options = new LoadSaveOptions(FileFormat.Docx);
options.OoxmlCompliance = OoxmlCompliance.Strict; // or Ecma, Transitional

var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler      = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);

Orijinal belgenin uyumluluğunu otomatik olarak nasıl korursunuz

var source = "template_transitional.docx"; // Document with Transitional compliance
var target = "output.docx";
var data   = "data.json";

// OoxmlCompliance is null by default – original compliance will be preserved
var options = new LoadSaveOptions(FileFormat.Docx);
// options.OoxmlCompliance remains null

var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler      = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// Output document keeps Transitional compliance

SdtRun içindeki satır içi içerik denetimlerinde şablon ifadelerini işleme

var source = "template_with_sdtrun.docx";
var target = "output.docx";
var data   = "data.json";

// Template document contains:
// - SdtBlock: <<[field1]>>
// - SdtRun (inline): <<[field2]>>   // Now correctly processed
// - Regular text: <<[field3]>>

var options = new LoadSaveOptions(FileFormat.Docx);
var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// All template expressions, including those in SdtRun, are replaced.

Düzeltmeler ve geliştirmeler

  • [Geliştirme] Codabar barkod üretimi artık minimum X‑boyutunu zorunlu kılıyor (ASSEMBLYNET‑75).
  • [Geliştirme] Linux’ta barkod renderı şeffaf renklerden kaçınıyor (ASSEMBLYNET‑76).
  • [Düzeltme] SdtRun denetimleri içindeki şablon ifadeleri işleniyor (ASSEMBLYNET‑73).
  • [Düzeltme] Linux (.NET 8) üzerinde barkodlar artık boş görünmüyor (ASSEMBLYNET‑60).

Güncellemeyi nasıl alabilirsiniz

  • NuGet – En son GroupDocs.Assembly paketine yükseltin:

    dotnet add package GroupDocs.Assembly --version 25.12

    (Aynı paket .NET 6+, .NET 5 ve .NET Framework 4.6.2 için çalışır.)

  • Direct download – .NET için derlenmiş derlemeleri resmi sürüm sayfasından indirin:

    GroupDocs.Assembly for .NET 25.12 DLLs only

Kaynaklar