Insérer des champs
Il existe plusieurs façons d’insérer des champs dans un document:
- utilisant DocumentBuilder
- utilisant FieldBuilder
- utilisant Aspose.Words Document Object Model (DOM)
Dans cet article, nous examinerons chaque manière plus en détail et analyserons comment insérer certains champs en utilisant ces options.
Insérer des champs dans un document en utilisant DocumentBuilder
En Aspose.Words des InsertField la méthode est utilisée pour insérer de nouveaux champs dans un document. Le premier paramètre accepte le code plein du champ à insérer. Le second paramètre est optionnel et permet de régler manuellement le résultat du champ. Si cela n’est pas fourni, le champ est mis à jour automatiquement. Vous pouvez passer null ou vide à ce paramètre pour insérer un champ avec une valeur de champ vide. Si vous n’êtes pas sûr de la syntaxe particulière du code de champ, créez le champ dans Microsoft Word d’abord et passer pour voir son code de champ.
L’exemple de code suivant montre comment insérer un champ de fusion dans un document en utilisant DocumentBuilder:
La même technique est utilisée pour insérer des champs nichés dans d’autres champs.
L’exemple de code suivant montre comment insérer des champs imbriqués dans un autre champ en utilisant DocumentBuilder:
Spécifier la zone au niveau du champ
Un identificateur de langue est une abréviation numérique internationale standard pour la langue d’un pays ou d’une région géographique. Avec Aspose.Words, vous pouvez spécifier la Locale au niveau du champ en utilisant LocaleId propriété, qui obtient ou définit l’identifiant local du champ.
L’exemple de code suivant montre comment utiliser cette option:
Insérer un champ non typé ou vide
Si vous voulez insérer des champs non tapés/vides ({}) comme Microsoft Word permet, vous pouvez utiliser InsertField méthode avec FieldType.FieldNone paramètre. Pour insérer un champ dans un document Word, vous pouvez appuyer sur la combinaison de touches -Ctrl + F9.
L’exemple de code suivant montre comment insérer un champ vide dans le document:
Insérer COMPARE Champ
Les COMPARE champ compare deux valeurs et retourne la valeur numérique 1 si la comparaison est true ou 0 si la comparaison est false.
L’exemple de code suivant montre comment ajouter COMPARE champs utilisant DocumentBuilder:
Insérer IF Champ
Les IF champ peut être utilisé pour évaluer les arguments conditionnellement.
L’exemple de code suivant montre comment ajouter IF champs utilisant DocumentBuilder:
Insérer des champs dans un document en utilisant FieldBuilder
La façon alternative d’insérer des champs dans Aspose.Words est la FieldBuilder En cours. Il fournit une interface fluide pour spécifier les interrupteurs de champ et les valeurs d’argument comme des champs texte, nœuds ou même imbriqués.
L’exemple de code suivant montre comment insérer un champ dans un document en utilisant FieldBuilder:
Insérer des champs en utilisant DOM
Vous pouvez également insérer différents types de champs en utilisant Aspose.Words Document Object Model (DOM). Dans cette section, nous examinerons quelques exemples.
Insérer la fusion Champ dans un document en utilisant DOM
MERGEFIELD champ dans le document Word peut être représenté par FieldMergeField En cours. Vous pouvez utiliser FieldMergeField classe pour effectuer les opérations suivantes:
- spécifier le nom du champ de fusion
- spécifier le formatage du champ de fusion
- spécifier le texte qui est entre le séparateur de champ et la fin du champ de fusion
- spécifier le texte à insérer après le champ de fusion si le champ n’est pas vide
- spécifier le texte à insérer avant le champ de fusion si le champ n’est pas vide
L’exemple de code suivant montre comment ajouter le MERGE champ en utilisant DOM au paragraphe d’un document:
Insérer Mail Merge ADDRESSBLOCK champ dans un document en utilisant DOM
Les ADDRESSBLOCK champ est utilisé pour insérer un mail merge bloc d’adresse dans un document Word. ADDRESSBLOCK champ dans le document Word peut être représenté par FieldAddressBlock En cours. Vous pouvez utiliser FieldAddressBlock classe pour effectuer les opérations suivantes:
- indiquer si le nom du pays ou de la région doit figurer dans le champ
- indiquer s’il convient de formater l’adresse selon le pays/région du destinataire tel que défini par POST*CODE (Union postale universelle 2006)
- préciser le nom du pays ou de la région exclu
- préciser le nom et le format de l’adresse
- spécifier l’identifiant de langue utilisé pour formater l’adresse
L’exemple de code suivant montre comment ajouter le Mail Merge ADDRESSBLOCK Champ utilisé DOM au paragraphe d’un document:
Insérer ADVANCE champ dans un document sans utiliser DocumentBuilder
Les ADVANCE champ est utilisé pour compenser le texte suivant dans une ligne vers la gauche, droite, haut ou bas. ADVANCE champ dans le document Word peut être représenté par FieldAdvance En cours. Vous pouvez utiliser le FieldAdvance classe pour effectuer les opérations suivantes:
- préciser le nombre de points par lesquels le texte qui suit le champ doit être déplacé verticalement depuis le bord supérieur de la page
- indiquer le nombre de points par lesquels le texte qui suit le champ doit être déplacé horizontalement du bord gauche de la colonne, du cadre ou de la zone de texte
- indiquer le nombre de points par lesquels le texte qui suit le champ doit être déplacé à gauche, à droite, en haut ou en bas
L’exemple de code suivant montre comment ajouter le ADVANCE Champ utilisé DOM au paragraphe d’un document:
Insérer ASK champ dans un document sans utiliser DocumentBuilder
Les ASK champ est utilisé pour inciter l’utilisateur à attribuer du texte à un signet dans le document Word. ASK champ dans le document Word peut être représenté par FieldAsk En cours. Vous pouvez utiliser FieldAsk classe pour effectuer les opérations suivantes:
- indiquer le nom du signet
- spécifier la réponse par défaut de l’utilisateur (valeur initiale contenue dans la fenêtre d’invite)
- préciser si la réponse de l’utilisateur doit être reçue une fois par mail merge fonctionnement
- spécifiez le texte de l’invite (le titre de la fenêtre de l’invite)
L’exemple de code suivant montre comment ajouter le ASK Champ utilisé DOM au paragraphe d’un document:
Insérer AUTHOR champ dans un document sans utiliser DocumentBuilder
Les AUTHOR le champ est utilisé pour spécifier le nom de l’auteur du document Document propriétés. AUTHOR champ dans le document Word peut être représenté par FieldAuthor En cours. Vous pouvez utiliser FieldAuthor classe pour effectuer les opérations suivantes:
- indiquer le nom de l’auteur du document
L’exemple de code suivant montre comment ajouter le AUTHOR Champ utilisé DOM au paragraphe d’un document:
Insérer INCLUDETEXT champ dans un document sans utiliser DocumentBuilder
Les INCLUDETEXT champ insère le texte et les graphiques contenus dans le document nommé dans le code de champ. Vous pouvez insérer le document entier ou une partie du document mentionné par un signet. Ce champ dans le document Word est représenté par INCLUDETEXT. Vous pouvez utiliser FieldIncludeText classe pour effectuer les opérations suivantes:
- indiquer le nom du signet du document inclus
- indiquer l’emplacement du document
L’exemple de code suivant montre comment ajouter le INCLUDETEXT champ en utilisant DOM au paragraphe d’un document:
Insérer TOA champ dans un document sans utiliser DocumentBuilder
Les TOA (Table des autorisations) construit et insère un tableau des autorisations. Les TOA champ collecte les entrées marquées par TA (Table des champs Autorisations Entrée). Microsoft Bureau Word insère le TOA champ lorsque vous cliquez sur Insérer le tableau des autorisations dans le Tableau des autorités sur le References onglet. Lorsque vous voyez le TOA champ dans votre document, la syntaxe ressemble à ceci:
{ TOA [Switches ] }
L’exemple de code suivant montre comment ajouter le TOA champ en utilisant DOM au paragraphe d’un document.