Inserisci campi
Ci sono diversi modi per inserire i campi in un documento:
- usando DocumentBuilder
- usando FieldBuilder
- usando Aspose.Words Document Object Model (DOM)
In questo articolo, vedremo ogni modo in modo più dettagliato e analizzare come inserire alcuni campi utilizzando queste opzioni.
Inserire i campi in un documento utilizzando DocumentBuilder
In Aspose.Words il InsertField il metodo viene utilizzato per inserire nuovi campi in un documento. Il primo parametro accetta il codice completo del campo da inserire. Il secondo parametro è facoltativo e consente di impostare manualmente il risultato del campo. Se questo non viene fornito, il campo viene aggiornato automaticamente. È possibile passare nullo o vuoto a questo parametro per inserire un campo con un valore di campo vuoto. Se non sei sicuro della particolare sintassi codice campo, creare il campo in Microsoft Word prima e passare a vedere il suo codice di campo.
Il seguente esempio di codice mostra come inserire un campo di fusione in un documento utilizzando DocumentBuilder:
La stessa tecnica viene utilizzata per inserire campi nidificati in altri campi.
Il seguente esempio di codice dimostra come inserire i campi nidificato in un altro campo utilizzando DocumentBuilder:
Specificare Locale a livello di campo
Un identificatore linguistico è un’abbreviazione numerica internazionale standard per la lingua in un paese o in una regione geografica. Con Aspose.Words, è possibile specificare il Locale a livello di campo utilizzando il LocaleId proprietà, che ottiene o imposta l’ID locale del campo.
Il seguente esempio di codice mostra come utilizzare questa opzione:
Inserire Untyped / Campo vuoto
Se si desidera inserire campi non digitati/vuoti ({}♪ just like Microsoft Word consente, è possibile utilizzare InsertField metodo con FieldType.FieldNone parametro. Per inserire un campo in un documento di Word, è possibile premere “Ctrl + F9” combinazione di tasti.
Il seguente esempio di codice mostra come inserire un campo vuoto nel documento:
Inserto COMPARE Campo
The COMPARE campo confronta due valori e restituisce il valore numerico 1 se il confronto è true o 0 se il confronto è false.
Il seguente esempio di codice mostra come aggiungere COMPARE campi utilizzando DocumentBuilder:
Inserto IF Campo
The IF campo può essere utilizzato per valutare gli argomenti condizionatamente.
Il seguente esempio di codice mostra come aggiungere IF campi utilizzando DocumentBuilder:
Inserire i campi in un documento utilizzando FieldBuilder
Il modo alternativo per inserire i campi in Aspose.Words è il FieldBuilder classe. Fornisce un’interfaccia fluente per specificare gli interruttori di campo e i valori di argomento come testo, nodi o anche campi nidificati.
Il seguente esempio di codice mostra come inserire un campo in un documento utilizzando FieldBuilder:
Inserimento di campi utilizzando DOM
È inoltre possibile inserire vari tipi di campi utilizzando Aspose.Words Document Object Model (DOM). In questa sezione, vedremo alcuni esempi.
Inserimento fusione Campo in un documento utilizzando DOM
MERGEFIELD campo nel documento di Word può essere rappresentato dal FieldMergeField classe. È possibile utilizzare FieldMergeField classe per eseguire le seguenti operazioni:
- specificare il nome del campo di fusione
- specificare la formattazione del campo di fusione
- specificare il testo che è tra il separatore di campo e l’estremità di campo del campo di fusione
- specificare il testo da inserire dopo il campo di fusione se il campo non è vuoto
- specificare il testo da inserire prima del campo di fusione se il campo non è vuoto
Il seguente esempio di codice mostra come aggiungere MERGE campo usando DOM a un paragrafo in un documento:
Inserimento Mail Merge ADDRESSBLOCK campo in un documento utilizzando DOM
The ADDRESSBLOCK campo viene utilizzato per inserire un mail merge blocco indirizzo in un documento di Word. ADDRESSBLOCK campo nel documento di Word può essere rappresentato dal FieldAddressBlock classe. È possibile utilizzare FieldAddressBlock classe per eseguire le seguenti operazioni:
- specificare se includere il nome del paese/regione nel campo
- specificare se formattare l’indirizzo in base al paese/regione del destinatario come definito da POST*CODE (Unione Postale Universale 2006)
- specificare il nome paese/regione esclusi
- specificare il formato nome e indirizzo
- specificare l’ID della lingua utilizzato per formattare l’indirizzo
Il seguente esempio di codice mostra come aggiungere Mail Merge ADDRESSBLOCK Campo usando DOM a un paragrafo in un documento:
Inserimento ADVANCE campo in un documento senza usare DocumentBuilder
The ADVANCE campo viene utilizzato per compensare il testo successivo all’interno di una linea a sinistra, destra, su o giù. ADVANCE campo nel documento di Word può essere rappresentato dal FieldAdvance classe. È possibile utilizzare FieldAdvance classe per eseguire le seguenti operazioni:
- specificare il numero di punti con cui il testo che segue il campo deve essere spostato verticalmente dal bordo superiore della pagina
- specificare il numero di punti con cui il testo che segue il campo deve essere spostato orizzontalmente dal bordo sinistro della colonna, cornice o casella di testo
- specificare il numero di punti con cui il testo che segue il campo deve essere spostato a sinistra, a destra, in alto o in basso
Il seguente esempio di codice mostra come aggiungere ADVANCE Campo usando DOM a un paragrafo in un documento:
Inserimento ASK campo in un documento senza usare DocumentBuilder
The ASK campo viene utilizzato per richiedere all’utente il testo per assegnare a un segnalibro nel documento di Word. ASK campo nel documento di Word può essere rappresentato dal FieldAsk classe. È possibile utilizzare FieldAsk classe per eseguire le seguenti operazioni:
- specificare il nome del segnalibro
- specificare la risposta utente predefinita (valore iniziale contenuto nella finestra del prompt)
- specificare se la risposta dell’utente deve essere ricevuta una volta per una mail merge operazione
- specificare il testo del prompt (il titolo della finestra del prompt)
Il seguente esempio di codice mostra come aggiungere ASK Campo usando DOM a un paragrafo in un documento:
Inserimento AUTHOR campo in un documento senza usare DocumentBuilder
The AUTHOR campo viene utilizzato per specificare il nome dell’autore di Documento dal Document proprietà. AUTHOR campo nel documento di Word può essere rappresentato dal FieldAuthor classe. È possibile utilizzare FieldAuthor classe per eseguire le seguenti operazioni:
- specificare il nome dell’autore del documento
Il seguente esempio di codice mostra come aggiungere AUTHOR Campo usando DOM a un paragrafo in un documento:
Inserimento INCLUDETEXT campo in un documento senza usare DocumentBuilder
The INCLUDETEXT campo inserisce il testo e la grafica contenuti nel documento denominato nel codice campo. È possibile inserire l’intero documento o una parte del documento di cui a un segnalibro. Questo campo nel documento di Word è rappresentato da INCLUDETEXT. È possibile utilizzare FieldIncludeText classe per eseguire le seguenti operazioni:
- specificare il nome del segnalibro del documento incluso
- specificare la posizione del documento
Il seguente esempio di codice mostra come aggiungere INCLUDETEXT campo usando DOM a un paragrafo in un documento:
Inserimento TOA campo in un documento senza usare DocumentBuilder
The TOA (Tabella delle autorità) campo costruisce e inserisce una tabella delle autorità. The TOA campi raccoglie le voci segnate da TA (Table of Authority Entry) campi. Microsoft Office Word inserisce il TOA campo quando si fa clic su Inserisci tabella delle autorità nel Tabella delle autorità gruppo sul References scheda. Quando si vede il TOA campo nel tuo documento, la sintassi assomiglia a questo:
{ TOA [Switches ] }
Il seguente esempio di codice mostra come aggiungere TOA campo usando DOM a un paragrafo in un documento.