MailMergeCleanupOptions

MailMergeCleanupOptions enumeration

Specifica le opzioni che determinano quali elementi vengono rimossi durante la stampa unione.

[Flags]
public enum MailMergeCleanupOptions

I valori

NomeValoreDescrizione
None0Specifica un valore predefinito.
RemoveEmptyParagraphs1Specifica se i paragrafi che contenevano campi di stampa unione senza dati devono essere rimossi dal documento. Quando questa opzione è impostata, vengono rimossi anche i paragrafi che contengono campi di inizio e fine regione che altrimenti sarebbero vuoti .
RemoveUnusedRegions2Specifica se le aree di stampa unione inutilizzate devono essere rimosse dal documento.
RemoveUnusedFields4Specifica se i campi di unione inutilizzati devono essere rimossi dal documento.
RemoveContainingFields8Specifica se i campi che contengono campi di unione (ad esempio IF) devono essere rimossi dal documento se i campi di unione nidificati vengono rimossi.
RemoveStaticFields10Specifica se i campi statici devono essere rimossi dal documento. I campi statici sono campi i cui risultati rimangono gli stessi dopo qualsiasi modifica del documento. I campi che non memorizzano i risultati in un document e vengono calcolati al volo (comeFieldListNum , FieldSymbol , ecc.) non sono considerati statici.
RemoveEmptyTableRows20Specifica se le righe vuote che contengono aree di stampa unione devono essere rimosse dal documento.

Esempi

Mostra come rimuovere i paragrafi vuoti che una stampa unione può creare dal documento di output dell’unione.

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

builder.InsertField(" MERGEFIELD TableStart:MyTable");
builder.InsertField(" MERGEFIELD FirstName ");
builder.Write(" ");
builder.InsertField(" MERGEFIELD LastName ");
builder.InsertField(" MERGEFIELD TableEnd:MyTable");

DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("LastName");
dataTable.Rows.Add(new object[] { "John", "Doe" });
dataTable.Rows.Add(new object[] { "", "" });
dataTable.Rows.Add(new object[] { "Jane", "Doe" });

doc.MailMerge.CleanupOptions = mailMergeCleanupOptions;
doc.MailMerge.ExecuteWithRegions(dataTable);

if (doc.MailMerge.CleanupOptions == MailMergeCleanupOptions.RemoveEmptyParagraphs) 
    Assert.AreEqual(
        "John Doe\r" +
        "Jane Doe", doc.GetText().Trim());
else
    Assert.AreEqual(
        "John Doe\r" +
        " \r" +
        "Jane Doe", doc.GetText().Trim());

Mostra come rimuovere automaticamente i MERGEFIELD che rimangono inutilizzati durante la stampa unione.

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

// Crea un documento con MERGEFIELD per tre colonne di una tabella di origini dati di stampa unione,
// e quindi crea una tabella con solo due colonne i cui nomi corrispondono ai nostri MERGEFIELD.
builder.InsertField(" MERGEFIELD FirstName ");
builder.Write(" ");
builder.InsertField(" MERGEFIELD LastName ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD City ");

DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("LastName");
dataTable.Rows.Add(new object[] { "John", "Doe" });
dataTable.Rows.Add(new object[] { "Joe", "Bloggs" });

// Il nostro terzo MERGEFIELD fa riferimento a una colonna "Città", che non esiste nella nostra origine dati.
// La stampa unione lascerà campi come questo intatti nello stato precedente all'unione.
// Impostando la proprietà "CleanupOptions" su "RemoveUnusedFields" verranno rimossi tutti i MERGEFIELD
// che rimangono inutilizzati durante una stampa unione per ripulire i documenti uniti.
doc.MailMerge.CleanupOptions = mailMergeCleanupOptions;
doc.MailMerge.Execute(dataTable);

if (mailMergeCleanupOptions == MailMergeCleanupOptions.RemoveUnusedFields || 
    mailMergeCleanupOptions == MailMergeCleanupOptions.RemoveStaticFields)
    Assert.AreEqual(0, doc.Range.Fields.Count);
else
    Assert.AreEqual(2, doc.Range.Fields.Count);

Guarda anche

MailMerge Class MailMergeRegionInfo Class