UseWholeParagraphAsRegion

MailMerge.UseWholeParagraphAsRegion property

يحصل على قيمة أو يعينها للإشارة إلى ما إذا كانت الفقرة بأكملها تحتوي علىبدء تشغيل الجدول أونهاية الجدول field أو نطاق معين بينبدء تشغيل الجدول ونهاية الجدول يجب تضمين الحقول في منطقة دمج البريد.

public bool UseWholeParagraphAsRegion { get; set; }

ملاحظات

القيمة الافتراضية هيحقيقي .

أمثلة

يُظهر العلاقة بين مناطق دمج البريد والفقرات.

public void UseWholeParagraphAsRegion(bool useWholeParagraphAsRegion)
{
    Document doc = CreateSourceDocWithNestedMergeRegions();
    DataTable dataTable = CreateSourceTableDataTableForOneRegion();

    // بشكل افتراضي، لا يمكن أن تنتمي الفقرة إلى أكثر من منطقة دمج بريد واحدة.
    //إن محتوى مستندنا لا يفي بهذه المعايير.
    // إذا قمنا بتعيين العلم "UseWholeParagraphAsRegion" إلى "true"،
    // سيؤدي تشغيل دمج البريد على هذا المستند إلى حدوث استثناء.
    // إذا قمنا بتعيين علامة "UseWholeParagraphAsRegion" إلى "false"،
    //سنكون قادرين على تنفيذ دمج البريد على هذا المستند.
    doc.MailMerge.UseWholeParagraphAsRegion = useWholeParagraphAsRegion;

    if (useWholeParagraphAsRegion)
        Assert.Throws<InvalidOperationException>(() => doc.MailMerge.ExecuteWithRegions(dataTable));
    else
        doc.MailMerge.ExecuteWithRegions(dataTable);

    // يملأ دمج البريد منطقتنا الأولى مع ترك المنطقة الثانية غير مستخدمة
    // بما أن المنطقة هي التي تكسر القاعدة.
    doc.Save(ArtifactsDir + "MailMerge.UseWholeParagraphAsRegion.docx");
}

/// <summary>
/// قم بإنشاء مستند يحتوي على منطقتين لدمج البريد تشتركان في فقرة واحدة.
/// </summary>
private static Document CreateSourceDocWithNestedMergeRegions()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.Write("Region 1: ");
    builder.InsertField(" MERGEFIELD TableStart:MyTable");
    builder.InsertField(" MERGEFIELD Column1");
    builder.Write(", ");
    builder.InsertField(" MERGEFIELD Column2");
    builder.InsertField(" MERGEFIELD TableEnd:MyTable");

    builder.Write(", Region 2: ");
    builder.InsertField(" MERGEFIELD TableStart:MyOtherTable");
    builder.InsertField(" MERGEFIELD TableEnd:MyOtherTable");

    return doc;
}

/// <summary>
/// قم بإنشاء جدول بيانات يمكنه ملء منطقة واحدة أثناء دمج البريد.
/// </summary>
private static DataTable CreateSourceTableDataTableForOneRegion()
{
    DataTable dataTable = new DataTable("MyTable");
    dataTable.Columns.Add("Column1");
    dataTable.Columns.Add("Column2");
    dataTable.Rows.Add(new object[] { "Value 1", "Value 2" });

    return dataTable;
}

أنظر أيضا

MailMerge.UseNonMergeFields MailMerge.DeleteFields