GroupDocs.Assembly برای .NET 25.12 – نکات برجسته انتشار دسامبر 2025

namespace GroupDocs.Assembly
{
    /// <summary>
    /// سطح سازگاری OOXML که هنگام ذخیره‌سازی اسناد Word به فرمت‌های OOXML استفاده می‌شود را مشخص می‌کند.
    /// </summary>
    public enum OoxmlCompliance
    {
        /// <summary>سازگاری ECMA‑376.</summary>
        Ecma,

        /// <summary>سازگاری ISO/IEC 29500:2008 Transitional.</summary>
        Transitional,

        /// <summary>سازگاری ISO/IEC 29500:2008 Strict.</summary>
        Strict
    }
}

public class LoadSaveOptions
{
    /// <summary>
    /// دریافت یا تنظیم سطح سازگاری OOXML که هنگام ذخیره‌سازی اسناد Word به فرمت‌های OOXML استفاده می‌شود.
    /// مقدار پیش‌فرض null است، به این معنی که سطح سازگاری به‌صورت خودکار تعیین می‌شود.
    /// </summary>
    public OoxmlCompliance? OoxmlCompliance { get; set; }
}

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

// ساخت LoadSaveOptions با سازگاری OOXML صریح
var options = new LoadSaveOptions(FileFormat.Docx);
options.OoxmlCompliance = OoxmlCompliance.Strict; // یا Ecma, Transitional

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

var source = "template_transitional.docx"; // سندی با سازگاری Transitional
var target = "output.docx";
var data   = "data.json";

// OoxmlCompliance به‌صورت پیش‌فرض null است – سازگاری اصلی حفظ می‌شود
var options = new LoadSaveOptions(FileFormat.Docx);
// options.OoxmlCompliance مقدار null باقی می‌ماند

var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler      = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// سند خروجی سازگاری Transitional را حفظ می‌کند

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

// سند قالب شامل:
// - SdtBlock: <<[field1]>>
// - SdtRun (درون‌خطی): <<[field2]>>   // اکنون به‌درستی پردازش می‌شود
// - متن عادی: <<[field3]>>

var options = new LoadSaveOptions(FileFormat.Docx);
var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// تمام عبارات قالب، از جمله آن‌ها در SdtRun، جایگزین می‌شوند.