Inserisci campo utilizzando il generatore di campi

Ecco una guida passo passo per spiegare il codice sorgente C# di seguito, che utilizza la funzionalità “Inserisci un campo utilizzando FieldBuilder” di Aspose.Words per .NET. Assicurati di seguire attentamente ogni passaggio per ottenere i risultati desiderati.

Passaggio 1: impostazione della directory dei documenti

Nel codice fornito, devi specificare la directory dei tuoi documenti. Sostituisci il valore “LA TUA DIRECTORY DOCUMENTI” con il percorso appropriato della directory dei tuoi documenti.

string dataDir = "YOUR DOCUMENTS DIRECTORY";

Passaggio 2: creazione del documento

Iniziamo creando un nuovo documento.

Document doc = new Document();

Passaggio 3: creazione del campo IF utilizzando FieldBuilder

Usiamo la classe FieldBuilder per costruire un campo IF con due campi MERGEFIELD nidificati. In questo esempio, il campo IF visualizza il nome e il cognome in base a una condizione.

FieldBuilder fieldBuilder = new FieldBuilder(FieldType.FieldIf)
     .AddArgument("left expression")
     .AddArgument("=")
     .AddArgument("right expression")
     .AddArgument(
         new FieldArgumentBuilder()
             .AddText("Firstname: ")
             .AddField(new FieldBuilder(FieldType.FieldMergeField).AddArgument("firstname")))
     .AddArgument(
         new FieldArgumentBuilder()
             .AddText("Lastname: ")
             .AddField(new FieldBuilder(FieldType.FieldMergeField).AddArgument("lastname")));

Passaggio 4: inserimento del campo IF nel documento

Noi usiamo ilBuildAndInsert() metodo per creare e inserire il campo IF in una posizione specifica nel documento.

Field field = fieldBuilder.BuildAndInsert(doc.FirstSection.Body.FirstParagraph);
field. Update();

Codice sorgente di esempio per l’inserimento di un campo utilizzando FieldBuilder con Aspose.Words per .NET

// Il percorso della directory dei documenti.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// Creazione di documenti.
Document doc = new Document();

// Costruzione del campo IF utilizzando FieldBuilder.
FieldBuilder fieldBuilder = new FieldBuilder(FieldType.FieldIf)
     .AddArgument("left expression")
     .AddArgument("=")
     .AddArgument("right expression")
     .AddArgument(
         new FieldArgumentBuilder()
             .AddText("Firstname: ")
             .AddField(new FieldBuilder(FieldType.FieldMergeField).AddArgument("firstname")))
     .AddArgument(
         new FieldArgumentBuilder()
             .AddText("Lastname: ")
             .AddField(new FieldBuilder(FieldType.FieldMergeField).AddArgument("lastname")));

// Inserisci il campo IF nel documento.
Field field = fieldBuilder.BuildAndInsert(doc.FirstSection.Body.FirstParagraph);
field. Update();

doc.Save(dataDir + "InsertFieldWithFieldBuilder.docx");

In questo esempio, abbiamo creato un nuovo documento, costruito un campo IF con campi MERGEFIELD nidificati e quindi inserito quel campo nel documento in una posizione specificata. Il documento viene quindi salvato con un nome file specifico.

Domande frequenti

D: Cos’è un costruttore di campi in Aspose.Words?

R: Un generatore di campi in Aspose.Words è un potente strumento per creare e manipolare campi in un documento Word. Offre funzionalità avanzate per la creazione e la personalizzazione dei campi, incluso l’inserimento di codici di campo e la gestione delle opzioni di formattazione.

D: Quali tipologie di campi possono essere inseriti utilizzando il generatore di campi?

R: Il generatore di campi in Aspose.Words ti consente di inserire diversi tipi di campi in un documento di Word. Ecco alcuni esempi di tipi di campo comunemente utilizzati:

• MERGEFIELD: utilizzato per unire dati provenienti da fonti esterne.
• DATA: visualizza la data corrente.
• PAGINA: visualizza il numero della pagina corrente.
• SE: permette di condizionare la visualizzazione di un contenuto secondo una condizione.
• TOC: genera automaticamente un sommario in base agli stili del titolo del documento.

D: Come personalizzare i campi inseriti con il generatore di campi?

R: Il generatore di campi offre opzioni di personalizzazione per i campi inseriti. È possibile utilizzare metodi e proprietà del costruttore di campi per impostare opzioni quali formattazione dei campi, argomenti, opzioni e valori predefiniti. Ad esempio, è possibile impostare il formato della data, il formato del numero, il separatore delle migliaia, ecc.