FieldOptions

FieldOptions class

Stellt Optionen zur Steuerung der Feldbehandlung in einem Dokument dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Feldern Dokumentationsartikel.

public sealed class FieldOptions

Eigenschaften

NameBeschreibung
BarcodeGenerator { get; set; }Ruft einen benutzerdefinierten Barcode-Generator ab oder legt ihn fest.
BibliographyStylesProvider { get; set; }Ruft einen Provider ab oder legt ihn fest, der einen Bibliographiestil für zurückgibt.FieldBibliography UndFieldCitation Felder.
BuiltInTemplatesPaths { get; set; }Ruft die Pfade der in MS Word integrierten Vorlagen ab oder legt sie fest.
ComparisonExpressionEvaluator { get; set; }Ruft den Evaluator für Feldvergleichsausdrücke ab oder legt ihn fest.
CurrentUser { get; set; }Ruft die aktuellen Benutzerinformationen ab oder legt sie fest.
CustomTocStyleSeparator { get; set; }Ruft einen benutzerdefinierten Stiltrenner für den \t-Schalter ab oder legt ihn fest inFieldToc Feld.
DefaultDocumentAuthor { get; set; }Ruft den Standardnamen des Dokumentautors ab oder legt ihn fest. Wenn der Name des Autors bereits in den integrierten Dokumenteigenschaften angegeben ist, wird diese Option nicht berücksichtigt.
FieldDatabaseProvider { get; set; }Ruft einen Provider ab oder legt ihn fest, der ein Abfrageergebnis für dieFieldDatabase Feld.
FieldIndexFormat { get; set; }Ruft ab oder setzt einenFieldIndexFormat das stellt die Formatierung für dieFieldIndex Felder im Dokument.
FieldUpdateCultureProvider { get; set; }Ruft einen Anbieter ab oder legt ihn fest, der ein für jedes einzelne Feld spezifisches Kulturobjekt zurückgibt.
FieldUpdateCultureSource { get; set; }Gibt an, welche Kultur zum Formatieren des Feldergebnisses verwendet werden soll.
FieldUpdatingCallback { get; set; }Ruft ab oder legt festIFieldUpdatingCallback Implementierung
FieldUpdatingProgressCallback { get; set; }Ruft ab oder legt festIFieldUpdatingProgressCallback Implementierung.
FileName { get; set; }Ruft den Dateinamen des Dokuments ab oder legt ihn fest.
IsBidiTextSupportedOnUpdate { get; set; }Ruft den Wert ab oder legt ihn fest, der angibt, ob bidirektionaler Text während der Feldaktualisierung vollständig unterstützt wird oder nicht.
LegacyNumberFormat { get; set; }Ruft den Wert ab oder legt ihn fest, der angibt, ob das veraltete Zahlenformat (vor AW 13.10) für Felder aktiviert ist oder nicht.
PreProcessCulture { get; set; }Ruft die Kultur zur Vorverarbeitung von Feldwerten ab oder legt sie fest.
ResultFormatter { get; set; }Ermöglicht die Steuerung der Formatierung des Feldergebnisses.
TemplateName { get; set; }Ruft den Dateinamen der vom Dokument verwendeten Vorlage ab oder legt ihn fest.
ToaCategories { get; set; }Ruft die Kategorien des Rechtsgrundlagenverzeichnisses ab oder legt sie fest.
UseInvariantCultureNumberFormat { get; set; }Ruft den Wert ab oder legt ihn fest, der angibt, ob das Zahlenformat mit invarianter Kultur analysiert wird oder nicht
UserPromptRespondent { get; set; }Ruft den Befragten für Benutzeraufforderungen während der Feldaktualisierung ab oder legt ihn fest.

Beispiele

Zeigt, wie die Quelle der Kultur angegeben wird, die während einer Feldaktualisierung oder eines Seriendrucks für die Datumsformatierung verwendet wird.

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

// Zwei Seriendruckfelder mit deutscher Gebietseinstellung einfügen.
builder.Font.LocaleId = new CultureInfo("de-DE").LCID;
builder.InsertField("MERGEFIELD Date1 \\@ \"dddd, d MMMM yyyy\"");
builder.Write(" - ");
builder.InsertField("MERGEFIELD Date2 \\@ \"dddd, d MMMM yyyy\"");

// Stellen Sie die aktuelle Kultur auf US-Englisch ein, nachdem Sie den ursprünglichen Wert in einer Variablen beibehalten haben.
CultureInfo currentCulture = Thread.CurrentThread.CurrentCulture;
Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");

// Bei dieser Zusammenführung wird die Kultur des aktuellen Threads (US-Englisch) zum Formatieren des Datums verwendet.
doc.MailMerge.Execute(new[] { "Date1" }, new object[] { new DateTime(2020, 1, 01) });

// Konfigurieren Sie die nächste Zusammenführung so, dass der Kulturwert aus dem Feldcode stammt. Der Wert dieser Kultur ist Deutsch.
doc.FieldOptions.FieldUpdateCultureSource = FieldUpdateCultureSource.FieldCode;
doc.MailMerge.Execute(new[] { "Date2" }, new object[] { new DateTime(2020, 1, 01) });

// Das erste Zusammenführungsergebnis enthält ein Datum im englischen Format, während das zweite im deutschen Format ist.
Assert.AreEqual("Wednesday, 1 January 2020 - Mittwoch, 1 Januar 2020", doc.Range.Text.Trim());

// Die ursprüngliche Kultur des Threads wiederherstellen.
Thread.CurrentThread.CurrentCulture = currentCulture;

Siehe auch