MergeWholeDocument

MailMerge.MergeWholeDocument property

Obtient ou définit une valeur indiquant si les champs de l’ensemble du document sont mis à jour lors de l’exécution d’un publipostage avec des régions.

public bool MergeWholeDocument { get; set; }

Remarques

La valeur par défaut estFAUX .

Exemples

Affiche la relation entre les publipostages avec les régions et la mise à jour des champs.

public void MergeWholeDocument(bool mergeWholeDocument)
{
    Document doc = CreateSourceDocMergeWholeDocument();
    DataTable dataTable = CreateSourceTableMergeWholeDocument();

    // Si on met le flag "MergeWholeDocument" à "true",
    // le publipostage avec les régions mettra à jour tous les champs du document.
    // Si nous mettons le flag "MergeWholeDocument" à "false", le publipostage ne mettra à jour que les champs
    // dans la région de publipostage dont le nom correspond au nom de la table source de données.
    doc.MailMerge.MergeWholeDocument = mergeWholeDocument;
    doc.MailMerge.ExecuteWithRegions(dataTable);

    // Le publipostage mettra uniquement à jour le champ QUOTE en dehors de la région de publipostage
    // si nous définissons le flag "MergeWholeDocument" sur "true".
    doc.Save(ArtifactsDir + "MailMerge.MergeWholeDocument.docx");

    Assert.True(doc.GetText().Contains("This QUOTE field is inside the \"MyTable\" merge region."));
    Assert.AreEqual(mergeWholeDocument, 
        doc.GetText().Contains("This QUOTE field is outside of the \"MyTable\" merge region."));
}

/// <summary>
/// Créez un document avec une région de publipostage appartenant à une source de données nommée "MaTable".
/// Insérez un champ QUOTE à l'intérieur de cette région et un autre à l'extérieur.
/// </summary>
private static Document CreateSourceDocMergeWholeDocument()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    FieldQuote field = (FieldQuote)builder.InsertField(FieldType.FieldQuote, true);
    field.Text = "This QUOTE field is outside of the \"MyTable\" merge region.";

    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD TableStart:MyTable");

    field = (FieldQuote)builder.InsertField(FieldType.FieldQuote, true);
    field.Text = "This QUOTE field is inside the \"MyTable\" merge region.";
    builder.InsertParagraph();

    builder.InsertField(" MERGEFIELD MyColumn");
    builder.InsertField(" MERGEFIELD TableEnd:MyTable");

    return doc;
}

/// <summary>
/// Créez une table de données qui sera utilisée dans un publipostage.
/// </summary>
private static DataTable CreateSourceTableMergeWholeDocument()
{
    DataTable dataTable = new DataTable("MyTable");
    dataTable.Columns.Add("MyColumn");
    dataTable.Rows.Add(new object[] { "MyValue" });

    return dataTable;
}

Voir également

MailMerge.MergeDuplicateRegions MailMerge.PreserveUnusedTags