UnconditionalMergeFieldsAndRegions

MailMerge.UnconditionalMergeFieldsAndRegions property

Ottiene o imposta un valore che indica se i campi di unione e le regioni di unione vengono uniti indipendentemente dalle condizioni del campo IF padre.

public bool UnconditionalMergeFieldsAndRegions { get; set; }

Osservazioni

Il valore predefinito è falso .

Esempi

Mostra come unire campi o regioni indipendentemente dalle condizioni del campo IF padre.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisce un MERGEFIELD annidato all'interno di un campo IF.
// Poiché l'istruzione del campo IF è falsa, non visualizzerà il risultato di MERGEFIELD.
// Anche il MERGEFIELD non riceverà alcun dato durante una stampa unione.
FieldIf fieldIf = (FieldIf)builder.InsertField(" IF 1 = 2 ");
builder.MoveTo(fieldIf.Separator);
builder.InsertField(" MERGEFIELD  FullName ");

// Se impostiamo il flag "UnconditionalMergeFieldsAndRegions" su "true",
// la nostra stampa unione inserirà i dati nei campi non visualizzati come il nostro MERGEFIELD e tutti gli altri.
// Se impostiamo il flag "UnconditionalMergeFieldsAndRegions" su "false",
// la nostra stampa unione non inserirà dati nei MERGEFIELD nascosti dai campi IF con dichiarazioni false.
doc.MailMerge.UnconditionalMergeFieldsAndRegions = countAllMergeFields;

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FullName");
dataTable.Rows.Add("James Bond");

doc.MailMerge.Execute(dataTable);

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

Assert.AreEqual(
    countAllMergeFields
        ? "\u0013 IF 1 = 2 \"James Bond\"\u0014\u0015"
        : "\u0013 IF 1 = 2 \u0013 MERGEFIELD  FullName \u0014«FullName»\u0015\u0014\u0015",
    doc.GetText().Trim());

Guarda anche