InsertField

InsertField(FieldType, bool, Node, bool)

Вставляет поле в этот абзац.

public Field InsertField(FieldType fieldType, bool updateField, Node refNode, bool isAfter)
ПараметрТипОписание
fieldTypeFieldTypeТип поля для вставки.
updateFieldBooleanУказывает, следует ли немедленно обновить поле.
refNodeNodeУзел ссылки внутри этого абзаца (еслиrefNode являетсянулевой, затем добавляется в конец абзаца).
isAfterBooleanВставлять ли поле после или до ссылочного узла.

Возвращаемое значение

АField объект, представляющий вставленное поле.

Примеры

Показаны различные способы добавления полей в абзац.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// Ниже приведены три способа вставки поля в абзац.
// 1 - Вставить поле AUTHOR в абзац после одного из дочерних узлов абзаца:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - Вставьте поле QUOTE после одного из дочерних узлов абзаца:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - Вставьте поле ЦИТАТА перед одним из дочерних узлов абзаца,
// и заставить его отображать значение-заполнитель:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Это поле будет отображать свое значение-заполнитель, пока мы его не обновим.
doc.UpdateFields();

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

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

Смотрите также


InsertField(string, Node, bool)

Вставляет поле в этот абзац.

public Field InsertField(string fieldCode, Node refNode, bool isAfter)
ПараметрТипОписание
fieldCodeStringКод поля для вставки (без фигурных скобок).
refNodeNodeУзел ссылки внутри этого абзаца (еслиrefNode являетсянулевой, затем добавляется в конец абзаца).
isAfterBooleanВставлять ли поле после или до ссылочного узла.

Возвращаемое значение

АField объект, представляющий вставленное поле.

Примеры

Показаны различные способы добавления полей в абзац.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// Ниже приведены три способа вставки поля в абзац.
// 1 - Вставить поле AUTHOR в абзац после одного из дочерних узлов абзаца:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - Вставьте поле QUOTE после одного из дочерних узлов абзаца:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - Вставьте поле ЦИТАТА перед одним из дочерних узлов абзаца,
// и заставить его отображать значение-заполнитель:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Это поле будет отображать свое значение-заполнитель, пока мы его не обновим.
doc.UpdateFields();

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

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

Смотрите также


InsertField(string, string, Node, bool)

Вставляет поле в этот абзац.

public Field InsertField(string fieldCode, string fieldValue, Node refNode, bool isAfter)
ПараметрТипОписание
fieldCodeStringКод поля для вставки (без фигурных скобок).
fieldValueStringЗначение поля для вставки. Пройтинулевой для полей, не имеющих значения.
refNodeNodeУзел ссылки внутри этого абзаца (еслиrefNode являетсянулевой, затем добавляется в конец абзаца).
isAfterBooleanВставлять ли поле после или до ссылочного узла.

Возвращаемое значение

АField объект, представляющий вставленное поле.

Примеры

Показаны различные способы добавления полей в абзац.

Document doc = new Document();
Paragraph para = doc.FirstSection.Body.FirstParagraph;

// Ниже приведены три способа вставки поля в абзац.
// 1 - Вставить поле AUTHOR в абзац после одного из дочерних узлов абзаца:
Run run = new Run(doc) { Text = "This run was written by " };
para.AppendChild(run);

doc.BuiltInDocumentProperties["Author"].Value = "John Doe";
para.InsertField(FieldType.FieldAuthor, true, run, true);

// 2 - Вставьте поле QUOTE после одного из дочерних узлов абзаца:
run = new Run(doc) { Text = "." };
para.AppendChild(run);

Field field = para.InsertField(" QUOTE \" Real value\" ", run, true);

// 3 - Вставьте поле ЦИТАТА перед одним из дочерних узлов абзаца,
// и заставить его отображать значение-заполнитель:
para.InsertField(" QUOTE \" Real value.\"", " Placeholder value.", field.Start, false);

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

// Это поле будет отображать свое значение-заполнитель, пока мы его не обновим.
doc.UpdateFields();

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

doc.Save(ArtifactsDir + "Paragraph.InsertField.docx");

Смотрите также