FieldAutoNum

FieldAutoNum class

Implementa il campo AUTONUM.

Per saperne di più, visita ilLavorare con i campi articolo di documentazione.

public class FieldAutoNum : Field

Costruttori

NomeDescrizione
FieldAutoNum()Default_Costruttore

Proprietà

NomeDescrizione
DisplayResult { get; }Ottiene il testo che rappresenta il risultato del campo visualizzato.
End { get; }Ottiene il nodo che rappresenta la fine del campo.
Format { get; }Ottiene aFieldFormat oggetto che fornisce accesso digitato alla formattazione del campo.
IsDirty { get; set; }Ottiene o imposta se il risultato corrente del campo non è più corretto (obsoleto) a causa di altre modifiche apportate al documento.
IsLocked { get; set; }Ottiene o imposta se il campo è bloccato (non deve ricalcolare il risultato).
LocaleId { get; set; }Ottiene o imposta l’LCID del campo.
Result { get; set; }Ottiene o imposta il testo compreso tra il separatore di campo e la fine del campo.
Separator { get; }Ottiene il nodo che rappresenta il separatore di campo. Può esserenullo .
SeparatorCharacter { get; set; }Ottiene o imposta il carattere separatore da utilizzare.
Start { get; }Ottiene il nodo che rappresenta l’inizio del campo.
virtual Type { get; }Ottiene il tipo di campo Microsoft Word.

Metodi

NomeDescrizione
GetFieldCode()Restituisce il testo compreso tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi secondari.
GetFieldCode(bool)Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non è presente alcun separatore).
Remove()Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo figlio del suo nodo genitore, restituisce il paragrafo genitore. Se il campo è già stato rimosso, restituiscenullo .
Unlink()Esegue lo scollegamento del campo.
Update()Esegue l’aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento.
Update(bool)Esegue un aggiornamento del campo. Genera un risultato se il campo è già in fase di aggiornamento.

Osservazioni

Inserisce un numero automatico.

Esempi

Mostra come numerare i paragrafi utilizzando i campi numerazione automatica.

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

// Ogni campo AUTONUM visualizza il valore corrente di un conteggio parziale di campi AUTONUM,
// permettendoci di numerare automaticamente gli elementi come un elenco numerato.
// Questo campo visualizzerà un numero "1.".
FieldAutoNum field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 1.");

Assert.AreEqual(" AUTONUM ", field.GetFieldCode());

field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 2.");

// Il carattere separatore, che appare nel risultato del campo immediatamente dopo il numero, è un punto per impostazione predefinita.
// Se lasciamo questa proprietà nulla, il nostro secondo campo AUTONUM visualizzerà "2." nel documento.
Assert.IsNull(field.SeparatorCharacter);

// Possiamo impostare questa proprietà per applicare il primo carattere della sua stringa come nuovo carattere separatore.
// In questo caso, il nostro campo AUTONUM ora visualizzerà "2:".
field.SeparatorCharacter = ":";

Assert.AreEqual(" AUTONUM  \\s :", field.GetFieldCode());

doc.Save(ArtifactsDir + "Field.AUTONUM.docx");

Guarda anche