FieldAutoNum
Contenuti
[
Nascondere
]FieldAutoNum class
Implementa il campo AUTONUM.
Per saperne di più, visita ilLavorare con i campi articolo di documentazione.
public class FieldAutoNum : Field
Costruttori
| Nome | Descrizione |
|---|---|
| FieldAutoNum() | Default_Costruttore |
Proprietà
| Nome | Descrizione |
|---|---|
| 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 unFieldFormatoggetto che fornisce accesso tipizzato 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 dovrebbe ricalcolare il suo 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ò esserenull . |
| 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 di Microsoft Word. |
Metodi
| Nome | Descrizione |
|---|---|
| GetFieldCode() | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è un separatore). Sono inclusi sia il codice di campo che il risultato del campo dei campi figlio. |
| GetFieldCode(bool) | Restituisce il testo tra l’inizio del campo e il separatore di campo (o la fine del campo se non c’è separatore). |
| Remove() | Rimuove il campo dal documento. Restituisce un nodo subito dopo il campo. Se la fine del campo è l’ultimo nodo figlio del suo nodo padre, restituisce il paragrafo padre. Se il campo è già stato rimosso, restituiscenull . |
| Unlink() | Esegue lo scollegamento del campo. |
| Update() | Esegue l’aggiornamento del campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
| Update(bool) | Esegue un aggiornamento di campo. Genera un’eccezione se il campo è già in fase di aggiornamento. |
Osservazioni
Inserisce un numero automatico.
Esempi
Mostra come numerare i paragrafi utilizzando i campi autonum.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Ogni campo AUTONUM visualizza il valore corrente di un conteggio corrente dei campi AUTONUM,
// consentendoci di numerare automaticamente gli elementi come in un elenco numerato.
// In questo campo verrà visualizzato il 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.");
// Per impostazione predefinita, il carattere separatore che appare nel risultato del campo subito dopo il numero è un punto.
// Se lasciamo questa proprietà null, il nostro secondo campo AUTONUM visualizzerà "2." nel documento.
Assert.IsNull(field.SeparatorCharacter);
// Possiamo impostare questa proprietà per applicare il primo carattere della stringa come nuovo carattere separatore.
// In questo caso, il nostro campo AUTONUM visualizzerà "2:".
field.SeparatorCharacter = ":";
Assert.AreEqual(" AUTONUM \\s :", field.GetFieldCode());
doc.Save(ArtifactsDir + "Field.AUTONUM.docx");
Guarda anche
- class Field
- spazio dei nomi Aspose.Words.Fields
- assemblea Aspose.Words
