PreserveUnusedTags
Innehåll
[
Dölj
]MailMerge.PreserveUnusedTags property
Hämtar eller ställer in ett värde som anger om de oanvända “mustasch”-taggarna ska bevaras.
public bool PreserveUnusedTags { get; set; }
Anmärkningar
Standardvärdet ärfalsk
.
Exempel
Visar hur man bevarar utseendet på alternativa kopplingsetiketter som inte används under en koppling.
public void PreserveUnusedTags(bool preserveUnusedTags)
{
Document doc = CreateSourceDocWithAlternativeMergeFields();
DataTable dataTable = CreateSourceTablePreserveUnusedTags();
// Som standard placerar en brevkoppling data från varje rad i en tabell i MERGEFIELDs, vilka namnger kolumner i den tabellen.
// Vårt dokument har inga sådana fält, men det har klartext-taggar omgivna av hängslen.
// Om vi ställer in flaggan "PreserveUnusedTags" till "true", kan vi behandla dessa taggar som MERGEFIELDs
// för att tillåta vår e-postsammanfogning för att infoga data från datakällan vid dessa taggar.
// Om vi sätter "PreserveUnusedTags"-flaggan till "false",
// sammanslagningen kommer att konvertera dessa taggar till MERGEFIELDs och lämna dem ofyllda.
doc.MailMerge.PreserveUnusedTags = preserveUnusedTags;
doc.MailMerge.Execute(dataTable);
doc.Save(ArtifactsDir + "MailMerge.PreserveUnusedTags.docx");
// Vårt dokument har en tagg för en kolumn som heter "Column2", som inte finns i tabellen.
// Om vi sätter "PreserveUnusedTags"-flaggan till "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>
/// Skapa ett dokument och lägg till två klartext-taggar som kan fungera som MERGEFIELDs under en e-postkoppling.
/// </summary>
private static Document CreateSourceDocWithAlternativeMergeFields()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("{{ Column1 }}");
builder.Writeln("{{ Column2 }}");
// Våra taggar registreras som destinationer för kopplingsdata endast om vi ställer in detta på sant.
doc.MailMerge.UseNonMergeFields = true;
return doc;
}
/// <summary>
/// Skapa en enkel datatabell med en kolumn.
/// </summary>
private static DataTable CreateSourceTablePreserveUnusedTags()
{
DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("Column1");
dataTable.Rows.Add(new object[] { "Value1" });
return dataTable;
}
Se även
- property UseNonMergeFields
- class MailMerge
- namnutrymme Aspose.Words.MailMerging
- hopsättning Aspose.Words