Felder einfügen
Es gibt verschiedene Möglichkeiten, Felder in ein Dokument einzufügen:
- verwenden von DocumentBuilder
- verwenden von FieldBuilder
- wobei Aspose.Words Dokumentobjektmodell (DOM)
In diesem Artikel werden wir uns jeden Weg genauer ansehen und analysieren, wie bestimmte Felder mit diesen Optionen eingefügt werden.
Einfügen von Feldern in ein Dokument mit DocumentBuilder
In Aspose.Words wird die InsertField -Methode verwendet, um neue Felder in ein Dokument einzufügen. Der erste Parameter akzeptiert den vollständigen Feldcode des einzufügenden Felds. Der zweite Parameter ist optional und ermöglicht die manuelle Einstellung des Feldergebnisses des Felds. Wenn dies nicht angegeben wird, wird das Feld automatisch aktualisiert. Sie können null oder empty an diesen Parameter übergeben, um ein Feld mit einem leeren Feldwert einzufügen. Wenn Sie sich über die bestimmte Feldcodesyntax nicht sicher sind, erstellen Sie zuerst das Feld in Microsoft Word und wechseln Sie, um den Feldcode anzuzeigen.
Das folgende Codebeispiel zeigt, wie Sie ein Seriendruckfeld mit DocumentBuilder in ein Dokument einfügen:
Dieselbe Technik wird verwendet, um Felder einzufügen, die in anderen Feldern verschachtelt sind.
Das folgende Codebeispiel zeigt, wie Sie mit DocumentBuilder in ein anderes Feld verschachtelte Felder einfügen:
Gebietsschema auf Feldebene angeben
Eine Sprachkennung ist eine internationale numerische Standardabkürzung für die Sprache in einem Land oder einer geografischen Region. Mit Aspose.Words können Sie das Gebietsschema auf Feldebene mithilfe der Eigenschaft LocaleId angeben, die das Gebietsschema ID des Felds abruft oder festlegt.
Das folgende Codebeispiel zeigt, wie diese Option verwendet wird:
Untypisiertes/leeres Feld einfügen
Wenn Sie nicht typisierte / leere Felder ({}) einfügen möchten, wie es Microsoft Word zulässt, können Sie die Methode InsertField mit dem Parameter FieldType.FieldNone verwenden. Um ein Feld in ein Word-Dokument einzufügen, können Sie die Tastenkombination “Strg + F9” drücken.
Das folgende Codebeispiel zeigt, wie Sie ein leeres Feld in das Dokument einfügen:
Einfügen von Feldern in ein Dokument mit FieldBuilder
Die alternative Möglichkeit, Felder in Aspose.Words einzufügen, ist die FieldBuilder -Klasse. Es bietet eine fließende Schnittstelle zum Angeben von Feldschaltern und Argumentwerten als Text, Knoten oder sogar verschachtelte Felder.
Das folgende Codebeispiel zeigt, wie Sie ein Feld mit FieldBuilder in ein Dokument einfügen:
Felder mit DOM einfügen
Sie können auch verschiedene Arten von Feldern einfügen mit Aspose.Words Dokumentobjektmodell (DOM). In diesem Abschnitt werden wir uns einige Beispiele ansehen.
Seriendruckfeld mit DOM in ein Dokument einfügen
Das Feld MERGEFIELD im Word-Dokument kann durch die Klasse FieldMergeField dargestellt werden. Sie können die Klasse FieldMergeField verwenden, um die folgenden Vorgänge auszuführen:
- geben Sie den Namen des Seriendruckfelds an
- geben Sie die Formatierung des Seriendruckfelds an
- geben Sie den Text zwischen dem Feldtrennzeichen und dem Feldende des Seriendruckfelds an
- geben Sie den Text an, der nach dem Seriendruckfeld eingefügt werden soll, wenn das Feld nicht leer ist
- geben Sie den Text an, der vor dem Seriendruckfeld eingefügt werden soll, wenn das Feld nicht leer ist
Das folgende Codebeispiel zeigt, wie Sie das Feld MERGE mit DOM zu einem Absatz in einem Dokument hinzufügen:
Einfügen eines Mail Merge-Adressblockfelds in ein Dokument mit DOM
Das Feld ADDRESSBLOCK wird verwendet, um einen Mail Merge -Adressblock in ein Word-Dokument einzufügen. Das Feld ADDRESSBLOCK im Word-Dokument kann durch die Klasse FieldAddressBlock dargestellt werden. Sie können die Klasse FieldAddressBlock verwenden, um die folgenden Vorgänge auszuführen:
- geben Sie an, ob der Name des Landes/der Region in das Feld aufgenommen werden soll
- geben Sie an, ob die Adresse entsprechend dem Land/der Region des Empfängers formatiert werden soll, wie in POST*CODE definiert (Weltpostverein 2006)
- geben Sie den Namen des ausgeschlossenen Landes/der ausgeschlossenen Region an
- geben Sie das Namens- und Adressformat an
- geben Sie die Sprache ID an, in der die Adresse formatiert wird
Das folgende Codebeispiel zeigt, wie Sie das Feld Mail Merge ADDRESSBLOCK mit DOM zu einem Absatz in einem Dokument hinzufügen:
Erweitertes Feld in ein Dokument einfügen, ohne DocumentBuilder zu verwenden
Das Feld ADVANCE wird verwendet, um nachfolgenden Text innerhalb einer Zeile nach links, rechts, oben oder unten zu verschieben. Das Feld ADVANCE im Word-Dokument kann durch die Klasse FieldAdvance dargestellt werden. Sie können die Klasse FieldAdvance verwenden, um die folgenden Vorgänge auszuführen:
- geben Sie die Anzahl der Punkte an, um die der Text, der auf das Feld folgt, vertikal vom oberen Rand der Seite verschoben werden soll
- geben Sie die Anzahl der Punkte an, um die der Text, der auf das Feld folgt, horizontal vom linken Rand der Spalte, des Rahmens oder des Textfelds verschoben werden soll
- geben Sie die Anzahl der Punkte an, um die der Text, der auf das Feld folgt, nach links, rechts, oben oder unten verschoben werden soll
Das folgende Codebeispiel zeigt, wie Sie das Feld ADVANCE mit DOM zu einem Absatz in einem Dokument hinzufügen:
ASK-Feld in ein Dokument einfügen, ohne DocumentBuilder zu verwenden
Das Feld ASK wird verwendet, um den Benutzer zur Eingabe von Text aufzufordern, der einem Lesezeichen im Word-Dokument zugewiesen werden soll. Das Feld ASK im Word-Dokument kann durch die Klasse FieldAsk dargestellt werden. Sie können die Klasse FieldAsk verwenden, um die folgenden Vorgänge auszuführen:
- geben Sie den Namen des Lesezeichens an
- Standardbenutzerantwort angeben (Anfangswert im Eingabeaufforderungsfenster enthalten)
- geben Sie an, ob die Benutzerantwort einmal pro mail merge-Vorgang empfangen werden soll
- geben Sie den Eingabeaufforderungstext an (den Titel des Eingabeaufforderungsfensters)
Das folgende Codebeispiel zeigt, wie Sie das Feld ASK mit DOM zu einem Absatz in einem Dokument hinzufügen:
AUTHOR-Feld in ein Dokument einfügen, ohne DocumentBuilder zu verwenden
Das Feld AUTHOR wird verwendet, um den Namen des Autors des Dokuments aus den Document-Eigenschaften anzugeben. Das Feld AUTHOR im Word-Dokument kann durch die Klasse FieldAuthor dargestellt werden. Sie können die Klasse FieldAuthor verwenden, um die folgenden Vorgänge auszuführen:
- geben Sie den Namen des Dokumentautors an
Das folgende Codebeispiel zeigt, wie Sie das Feld AUTHOR mit DOM zu einem Absatz in einem Dokument hinzufügen:
INCLUDETEXT-Feld in ein Dokument einfügen, ohne DocumentBuilder zu verwenden
Das Feld INCLUDETEXT fügt den Text und die Grafiken ein, die in dem im Feldcode genannten Dokument enthalten sind. Sie können das gesamte Dokument oder einen Teil des Dokuments einfügen, auf das durch ein Lesezeichen verwiesen wird. Dieses Feld im Word-Dokument wird durch INCLUDETEXT dargestellt. Sie können die Klasse FieldIncludeText verwenden, um die folgenden Operationen auszuführen:
- geben Sie den Namen des Lesezeichens des enthaltenen Dokuments an
- geben Sie den Speicherort des Dokuments an
Das folgende Codebeispiel zeigt, wie Sie das Feld INCLUDETEXT mit DOM zu einem Absatz in einem Dokument hinzufügen:
TOA-Feld in ein Dokument einfügen, ohne DocumentBuilder zu verwenden
Das Feld TOA (Table of Authorities) erstellt und fügt eine Tabelle mit Berechtigungen ein. Das Feld TOA sammelt Einträge, die mit TA (Table of Authorities Entry) Feldern markiert sind. Microsoft Office Word fügt das Feld TOA ein, wenn Sie auf Insert Table of Authorities in der Gruppe Table of Authorities auf der Registerkarte References klicken. Wenn Sie das Feld TOA in Ihrem Dokument anzeigen, sieht die Syntax folgendermaßen aus:
{ TOA [Switches ] }
Das folgende Codebeispiel zeigt, wie Sie das Feld TOA mit DOM zu einem Absatz in einem Dokument hinzufügen:
/