FieldAutoNum

FieldAutoNum class

Implementerar fältet AUTONUM.

public class FieldAutoNum : Field

Konstruktörer

namn Beskrivning
FieldAutoNum() Default_Constructor

Egenskaper

namn Beskrivning
DisplayResult { get; } Hämtar texten som representerar det visade fältresultatet.
End { get; } Hämtar noden som representerar fältänden.
Format { get; } Får enFieldFormat objekt som ger maskinskriven åtkomst till fältets formatering.
IsDirty { get; set; } Hämtar eller ställer in om det aktuella resultatet av fältet inte längre är korrekt (inaktuellt) på grund av andra ändringar som gjorts i dokumentet.
IsLocked { get; set; } Hämtar eller ställer in om fältet är låst (ska inte räkna om resultatet).
LocaleId { get; set; } Hämtar eller ställer in LCID för fältet.
Result { get; set; } Hämtar eller ställer in text som är mellan fältavgränsaren och fältslutet.
Separator { get; } Hämtar noden som representerar fältseparatorn. Kan vara null.
SeparatorCharacter { get; set; } Hämtar eller ställer in avgränsningstecknet som ska användas.
Start { get; } Hämtar noden som representerar början av fältet.
virtual Type { get; } Hämtar fälttypen Microsoft Word.

Metoder

namn Beskrivning
GetFieldCode() Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare). Både fältkod och fältresultat för underordnade fält ingår.
GetFieldCode(bool) Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare).
Remove() Tar bort fältet från dokumentet. Returnerar en nod direkt efter fältet. Om fältets slut är den sista child av dess överordnade nod, returnerar dess överordnade stycke. Om fältet redan är borttaget, returneras null .
Unlink() Utför fältavlänkningen.
Update() Utför fältuppdateringen. Kastar om fältet redan uppdateras.
Update(bool) Utför en fältuppdatering. Kastar om fältet redan uppdateras.

Anmärkningar

Infogar ett automatiskt nummer.

Exempel

Visar hur man numrerar stycken med autonumeriska fält.

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

// Varje AUTONUM-fält visar det aktuella värdet av ett löpande antal AUTONUM-fält,
// tillåter oss att automatiskt numrera objekt som en numrerad lista.
// Detta fält kommer att visa siffran "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.");

// Skiljetecknet, som visas i fältresultatet omedelbart efter numret, är som standard ett punkt.
// Om vi lämnar den här egenskapen null, kommer vårt andra AUTONUM-fält att visa "2." i dokumentet.
Assert.IsNull(field.SeparatorCharacter);

// Vi kan ställa in den här egenskapen för att tillämpa det första tecknet i dess sträng som det nya separatortecknet.
// I detta fall kommer vårt AUTONUM-fält nu att visa "2:".
field.SeparatorCharacter = ":";

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

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

Se även