UseNonMergeFields

MailMerge.UseNonMergeFields property

Quandvrai , spécifie qu’en plus des champs MERGEFIELD, le publipostage est effectué dans d’autres types de champs et également dans les balises “{{fieldName}}”.

public bool UseNonMergeFields { get; set; }

Remarques

Normalement, le publipostage n’est effectué que dans les champs MERGEFIELD, mais plusieurs clients ont fait construire leur reporting à l’aide d’autres champs et ont créé de nombreux documents de cette manière. Pour simplifier la migration (et parce que l’approche this a été utilisée indépendamment par plusieurs clients), la possibilité de fusion et de publipostage dans d’autres champs a été introduite.

QuandUseNonMergeFields est réglé survrai, Aspose.Words effectuera un publipostage dans les champs suivants :

MERGEFIELD Nom du champ

MACROBUTTON NOMACRO NomChamp

SI 0 = 0 “{FieldName}” ""

Aussi, quandUseNonMergeFields est réglé survrai, Aspose.Words effectuera un publipostage dans le texte tags “{{fieldName}}”. Ce ne sont pas des champs, mais simplement des balises de texte.

Exemples

Montre comment conserver l’apparence des balises de publipostage alternatives qui restent inutilisées lors d’un publipostage.

public void PreserveUnusedTags(bool preserveUnusedTags)
{
    Document doc = CreateSourceDocWithAlternativeMergeFields();
    DataTable dataTable = CreateSourceTablePreserveUnusedTags();

     // Par défaut, un publipostage place les données de chaque ligne d'une table dans des MERGEFIELD, qui nomment les colonnes de cette table.
    // Notre document ne contient pas de tels champs, mais il contient des balises de texte en clair entourées d'accolades.
    // Si nous définissons le flag "PreserveUnusedTags" sur "true", nous pourrions traiter ces balises comme des MERGEFIELD
    // pour permettre à notre publipostage d'insérer des données de la source de données au niveau de ces balises.
    // Si on met le flag "PreserveUnusedTags" à "false",
    // le publipostage convertira ces balises en MERGEFIELD et les laissera vides.
    doc.MailMerge.PreserveUnusedTags = preserveUnusedTags;
    doc.MailMerge.Execute(dataTable);

    doc.Save(ArtifactsDir + "MailMerge.PreserveUnusedTags.docx");

    // Notre document possède une balise pour une colonne nommée "Colonne2", qui n'existe pas dans le tableau.
    // Si on met le flag "PreserveUnusedTags" à "false", then the mail merge will convert this tag into a MERGEFIELD.
    Assert.AreEqual(doc.GetText().Contains("{{ Column2 }}"), preserveUnusedTags);

    if (preserveUnusedTags)
        Assert.AreEqual(0, doc.Range.Fields.Count(f => f.Type == FieldType.FieldMergeField));
    else
        Assert.AreEqual(1, doc.Range.Fields.Count(f => f.Type == FieldType.FieldMergeField));
}

/// <summary>
/// Créez un document et ajoutez deux balises de texte en clair qui peuvent agir comme MERGEFIELD lors d'un publipostage.
/// </summary>
private static Document CreateSourceDocWithAlternativeMergeFields()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.Writeln("{{ Column1 }}");
    builder.Writeln("{{ Column2 }}");

    // Nos balises s'enregistreront en tant que destinations pour les données de publipostage uniquement si nous définissons cela sur true.
    doc.MailMerge.UseNonMergeFields = true;

    return doc;
}

/// <summary>
/// Créez un tableau de données simple avec une colonne.
/// </summary>
private static DataTable CreateSourceTablePreserveUnusedTags()
{
    DataTable dataTable = new DataTable("MyTable");
    dataTable.Columns.Add("Column1");
    dataTable.Rows.Add(new object[] { "Value1" });

    return dataTable;
}

Voir également

MailMerge.UnconditionalMergeFieldsAndRegions MailMerge.UseWholeParagraphAsRegion