Class MailMergeOptions
Namespace: Aspose.Words.LowCode
Assembly: Aspose.Words.dll
Reprezentuje opcje funkcjonalności scalania poczty.
public class MailMergeOptions
Dziedziczenie
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktorzy
MailMergeOptions()
public MailMergeOptions()
Właściwości
CleanupOptions
Pobiera lub ustawia zestaw flag, które określają, jakie elementy powinny być usunięte podczas scalania poczty.
public MailMergeCleanupOptions CleanupOptions { get; set; }
Wartość właściwości
CleanupParagraphsWithPunctuationMarks
Pobiera lub ustawia wartość wskazującą, czy akapity z znakami interpunkcyjnymi są uważane za puste i powinny być usunięte, jeśli opcja Aspose.Words.MailMerging.MailMergeCleanupOptions.RemoveEmptyParagraphs jest określona.
public bool CleanupParagraphsWithPunctuationMarks { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to true
.
MergeDuplicateRegions
Pobiera lub ustawia wartość wskazującą, czy wszystkie regiony scalania poczty w dokumencie o nazwie źródła danych powinny być scalane podczas wykonywania scalania poczty z regionami w stosunku do źródła danych, czy tylko pierwszy.
public bool MergeDuplicateRegions { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to false
.
MergeWholeDocument
Pobiera lub ustawia wartość wskazującą, czy pola w całym dokumencie są aktualizowane podczas wykonywania scalania poczty z regionami.
public bool MergeWholeDocument { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to false
.
PreserveUnusedTags
Pobiera lub ustawia wartość wskazującą, czy nieużywane tagi “mustache” powinny być zachowane.
public bool PreserveUnusedTags { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to false
.
Zobacz także
MailMergeOptions.UseNonMergeFields
RegionEndTag
Pobiera lub ustawia tag końca regionu scalania poczty.
public string RegionEndTag { get; set; }
Wartość właściwości
RegionStartTag
Pobiera lub ustawia tag początku regionu scalania poczty.
public string RegionStartTag { get; set; }
Wartość właściwości
RestartListsAtEachSection
Pobiera lub ustawia wartość wskazującą, czy listy są restartowane w każdej sekcji po wykonaniu scalania poczty.
public bool RestartListsAtEachSection { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to true
.
RetainFirstSectionStart
Pobiera lub ustawia wartość wskazującą, czy początek sekcji pierwszej sekcji dokumentu i jej kopie dla kolejnych wierszy źródła danych są zachowane podczas scalania poczty, czy aktualizowane zgodnie z zachowaniem MS Word.
public bool RetainFirstSectionStart { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to true
.
TrimWhitespaces
Pobiera lub ustawia wartość wskazującą, czy białe znaki na końcu i na początku są usuwane z wartości scalania poczty.
public bool TrimWhitespaces { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to true
.
UnconditionalMergeFieldsAndRegions
Pobiera lub ustawia wartość wskazującą, czy pola scalania i regiony scalania są scalane niezależnie od warunku pola IF rodzica.
public bool UnconditionalMergeFieldsAndRegions { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to false
.
UseNonMergeFields
Gdy true
, określa, że oprócz pól MERGEFIELD, scalanie poczty jest wykonywane także w niektórych innych typach pól oraz
także w tagach “{{fieldName}}”.
public bool UseNonMergeFields { get; set; }
Wartość właściwości
Uwagi
Normalnie, scalanie poczty jest wykonywane tylko w polach MERGEFIELD, ale kilku klientów miało swoje raporty zbudowane przy użyciu innych pól i miało wiele dokumentów stworzonych w ten sposób. Aby uprościć migrację (i ponieważ to podejście było niezależnie używane przez kilku klientów), wprowadzono możliwość scalania poczty w innych polach.
Kiedy Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields jest ustawione na true
, Aspose.Words wykona scalanie poczty w następujących polach:
MERGEFIELD FieldName
MACROBUTTON NOMACRO FieldName
IF 0 = 0 "{FieldName}" ""
Również, kiedy Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields jest ustawione na true
, Aspose.Words wykona scalanie poczty w tagach tekstowych
"{{fieldName}}". To nie są pola, a jedynie tagi tekstowe.
UseWholeParagraphAsRegion
Pobiera lub ustawia wartość wskazującą, czy cały akapit z polem TableStart lub TableEnd lub konkretny zakres między polami TableStart i TableEnd powinien być uwzględniony w regionie scalania.
public bool UseWholeParagraphAsRegion { get; set; }
Wartość właściwości
Uwagi
Wartość domyślna to true
.