FieldDocVariable
Innehåll
[
Dölj
]FieldDocVariable class
Implementerar DOCVARIABLE-fältet.
För att lära dig mer, besökArbeta med Fields dokumentationsartikel.
public class FieldDocVariable : Field
Konstruktörer
| namn | Beskrivning |
|---|---|
| FieldDocVariable() | 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 varanull . |
| Start { get; } | Hämtar noden som representerar början av fältet. |
| virtual Type { get; } | Hämtar fälttypen Microsoft Word. |
| VariableName { get; set; } | Hämtar eller ställer in namnet på dokumentvariabeln som ska hämtas. |
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, returnerasnull . |
| 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. |
Exempel
Visar hur du använder DOCPROPERTY-fält för att visa dokumentegenskaper och variabler.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Nedan finns två sätt att använda DOCPROPERTY-fält.
// 1 - Visa en inbyggd egenskap:
// Ställ in ett anpassat värde för den inbyggda "Kategori"-egenskapen och infoga sedan ett DOCPROPERTY-fält som refererar till det.
doc.BuiltInDocumentProperties.Category = "My category";
FieldDocProperty fieldDocProperty = (FieldDocProperty)builder.InsertField(" DOCPROPERTY Category ");
fieldDocProperty.Update();
Assert.AreEqual(" DOCPROPERTY Category ", fieldDocProperty.GetFieldCode());
Assert.AreEqual("My category", fieldDocProperty.Result);
builder.InsertParagraph();
// 2 - Visa en anpassad dokumentvariabel:
// Definiera en anpassad variabel och referera sedan till den variabeln med ett DOCPROPERTY-fält.
Assert.That(doc.Variables, Is.Empty);
doc.Variables.Add("My variable", "My variable's value");
FieldDocVariable fieldDocVariable = (FieldDocVariable)builder.InsertField(FieldType.FieldDocVariable, true);
fieldDocVariable.VariableName = "My Variable";
fieldDocVariable.Update();
Assert.AreEqual(" DOCVARIABLE \"My Variable\"", fieldDocVariable.GetFieldCode());
Assert.AreEqual("My variable's value", fieldDocVariable.Result);
doc.Save(ArtifactsDir + "Field.DOCPROPERTY.DOCVARIABLE.docx");
Se även
- class Field
- namnutrymme Aspose.Words.Fields
- hopsättning Aspose.Words
