InsertField

InsertField(FieldType, bool)

Infogar ett Word-fält i ett dokument och uppdaterar valfritt fältresultatet.

public Field InsertField(FieldType fieldType, bool updateField)
ParameterTypBeskrivning
fieldTypeFieldTypeTypen av fält som ska läggas till.
updateFieldBooleanAnger om fältet ska uppdateras omedelbart.

Returvärde

EnField objekt som representerar det infogade fältet.

Anmärkningar

Den här metoden infogar ett fält i ett dokument. Aspose.Words kan uppdatera fält av de flesta typer, men inte alla. För mer information, se InsertField överbelastning.

Exempel

Visar hur man infogar ett fält i ett dokument med hjälp av FieldType.

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

// Infoga två fält samtidigt som en flagga skickas som avgör om de ska uppdateras när byggaren infogar dem.
// I vissa fall kan det vara beräkningsmässigt dyrt att uppdatera fält, och det kan vara en bra idé att skjuta upp uppdateringen.
doc.BuiltInDocumentProperties.Author = "John Doe";
builder.Write("This document was written by ");
builder.InsertField(FieldType.FieldAuthor, updateInsertedFieldsImmediately);

builder.InsertParagraph();
builder.Write("\nThis is page ");
builder.InsertField(FieldType.FieldPage, updateInsertedFieldsImmediately);

Assert.AreEqual(" AUTHOR ", doc.Range.Fields[0].GetFieldCode());
Assert.AreEqual(" PAGE ", doc.Range.Fields[1].GetFieldCode());

if (updateInsertedFieldsImmediately)
{
    Assert.AreEqual("John Doe", doc.Range.Fields[0].Result);
    Assert.AreEqual("1", doc.Range.Fields[1].Result);
}
else
{
    Assert.AreEqual(string.Empty, doc.Range.Fields[0].Result);
    Assert.AreEqual(string.Empty, doc.Range.Fields[1].Result);

    // Vi måste uppdatera dessa fält manuellt med hjälp av uppdateringsmetoderna.
    doc.Range.Fields[0].Update();

    Assert.AreEqual("John Doe", doc.Range.Fields[0].Result);

    doc.UpdateFields();

    Assert.AreEqual("1", doc.Range.Fields[1].Result);
}

Se även

InsertField(string)

Infogar ett Word-fält i ett dokument och uppdaterar fältresultatet.

public Field InsertField(string fieldCode)
ParameterTypBeskrivning
fieldCodeStringFältkoden som ska infogas (utan klammerparenteser).

Returvärde

EnField objekt som representerar det infogade fältet.

Anmärkningar

Den här metoden infogar ett fält i ett dokument och uppdaterar fältresultatet omedelbart. Aspose.Words kan uppdatera fält av de flesta typer, men inte alla. För mer information, se InsertField överbelastning.

Exempel

Visar hur man infogar ett fält i ett dokument med hjälp av en fältkod.

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

Field field = builder.InsertField("DATE \\@ \"dddd, MMMM dd, yyyy\"");

Assert.AreEqual(FieldType.FieldDate, field.Type);
Assert.AreEqual("DATE \\@ \"dddd, MMMM dd, yyyy\"", field.GetFieldCode());

// Denna överbelastning av InsertField-metoden uppdaterar automatiskt infogade fält.
Assert.True((DateTime.Today - DateTime.Parse(field.Result)).Days <= 1);

Visar hur man infogar fält och flyttar dokumentbyggarens markör till dem.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(@"MERGEFIELD MyMergeField1 \* MERGEFORMAT");
builder.InsertField(@"MERGEFIELD MyMergeField2 \* MERGEFORMAT");

// Flytta markören till det första MERGEFIELD.
builder.MoveToMergeField("MyMergeField1", true, false);

// Observera att markören placeras omedelbart efter det första MERGEFIELD-värdet och före det andra.
Assert.AreEqual(doc.Range.Fields[1].Start, builder.CurrentNode);
Assert.AreEqual(doc.Range.Fields[0].End, builder.CurrentNode.PreviousSibling);

// Om vi vill redigera fältets fältkod eller innehåll med hjälp av verktyget,
// dess markör skulle behöva vara inuti ett fält.
// För att placera den inuti ett fält skulle vi behöva anropa dokumentbyggarens MoveTo-metod
// och skicka fältets start- eller separatornod som ett argument.
builder.Write(" Text between our merge fields. ");

doc.Save(ArtifactsDir + "DocumentBuilder.MergeFields.docx");

Se även

InsertField(string, string)

Infogar ett Word-fält i ett dokument utan att uppdatera fältresultatet.

public Field InsertField(string fieldCode, string fieldValue)
ParameterTypBeskrivning
fieldCodeStringFältkoden som ska infogas (utan klammerparenteser).
fieldValueStringFältvärdet som ska infogas. Passnull för fält som inte har ett värde.

Returvärde

EnField objekt som representerar det infogade fältet.

Anmärkningar

Fält i Microsoft Word-dokument består av en fältkod och ett fältresultat. Fältkoden är som en formel och fältresultatet är som det värde som formeln producerar. Fältkoden kan också innehålla fältväxlar som fungerar som ytterligare instruktioner för att utföra en specifik åtgärd.

Du kan växla mellan att visa fältkoder och resultat i ditt dokument i Microsoft Word med hjälp av kortkommandot Alt+F9. Fältkoder visas mellan klammerparenteser ({}).

För att skapa ett fält måste du ange en fälttyp, fältkod och ett “platshållarvärde” för fältet. Om du är osäker på syntaxen för en viss fältkod, skapa först fältet i Microsoft Word och växla för att se dess fältkod.

Aspose.Words kan beräkna fältresultat för de flesta fälttyper, men den här metoden uppdaterar inte fältresultatet automatiskt. Eftersom fältresultatet inte beräknas automatiskt, förväntas du skicka ett strängvärde (eller till och med en tom sträng) som infogas i fältresultatet. Detta värde kommer att finnas kvar i fältresultatet som en platshållare tills fältet uppdateras. För att uppdatera fältresultatet kan du anropaUpdate på fältet objektet returned till dig ellerUpdateFields för att uppdatera fält i hela dokumentet.

Exempel

Visar hur man ställer in sidnumrering i ett avsnitt.

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

builder.Writeln("Section 1, page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 1, page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 1, page 3.");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Writeln("Section 2, page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 2, page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Section 2, page 3.");

// Flytta dokumentbyggaren till den första sektionens primära rubrik,
// som varje sida i det avsnittet kommer att visa.
builder.MoveToSection(0);
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

// Infoga ett PAGE-fält, som visar numret på den aktuella sidan.
builder.Write("Page ");
builder.InsertField("PAGE", "");

// Konfigurera sektionen så att sidantalet som PAGE-fälten visar börjar från 5.
// Konfigurera också alla PAGE-fält så att deras sidnummer visas med versaler i romerska siffror.
PageSetup pageSetup = doc.Sections[0].PageSetup;
pageSetup.RestartPageNumbering = true;
pageSetup.PageStartingNumber = 5;
pageSetup.PageNumberStyle = NumberStyle.UppercaseRoman;

// Skapa ytterligare en primär rubrik för den andra sektionen, med ytterligare ett PAGE-fält.
builder.MoveToSection(1);
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;
builder.Write(" - ");
builder.InsertField("PAGE", "");
builder.Write(" - ");

// Konfigurera sektionen så att sidantalet som PAGE-fälten visar börjar från 10.
// Konfigurera också alla PAGE-fält så att deras sidnummer visas med arabiska siffror.
pageSetup = doc.Sections[1].PageSetup;
pageSetup.PageStartingNumber = 10;
pageSetup.RestartPageNumbering = true;
pageSetup.PageNumberStyle = NumberStyle.Arabic;

doc.Save(ArtifactsDir + "PageSetup.PageNumbering.docx");

Se även

DocumentBuilder.InsertDocumentInline DocumentBuilder.InsertFootnote