FieldCitation

FieldCitation class

Реализует поле CITATION.

Чтобы узнать больше, посетитеРабота с полями документальная статья.

public class FieldCitation : Field

Конструкторы

ИмяОписание
FieldCitation()Конструктор по умолчанию.

Характеристики

ИмяОписание
AnotherSourceTag { get; set; }Возвращает или задает значение, соответствующееЯрлык значение элемента другого источника, которое будет включено в цитату.
DisplayResult { get; }Получает текст, представляющий отображаемый результат поля.
End { get; }Получает узел, представляющий конец поля.
Format { get; }ПолучаетFieldFormatобъект, который обеспечивает типизированный доступ к форматированию поля.
FormatLanguageId { get; set; }Возвращает или задает идентификатор языка, который используется вместе с указанным библиографическим стилем для форматирования цитаты в документе.
IsDirty { get; set; }Возвращает или задает, является ли текущий результат поля более неверным (устаревшим) из-за других изменений, внесенных в документ.
IsLocked { get; set; }Возвращает или задает, заблокировано ли поле (не следует пересчитывать его результат).
LocaleId { get; set; }Получает или задает LCID поля.
PageNumber { get; set; }Возвращает или задает номер страницы, связанный с цитатой.
Prefix { get; set; }Получает или задает префикс, добавляемый к цитате.
Result { get; set; }Возвращает или задает текст, который находится между разделителем полей и концом поля.
Separator { get; }Получает узел, представляющий разделитель полей. Может бытьнулевой .
SourceTag { get; set; }Возвращает или задает значение, соответствующееЯрлык значение элемента источника для вставки.
Start { get; }Получает узел, представляющий начало поля.
Suffix { get; set; }Получает или задает суффикс, добавляемый к цитате.
SuppressAuthor { get; set; }Возвращает или задает, будет ли информация об авторе скрыта из цитаты.
SuppressTitle { get; set; }Возвращает или задает, будет ли информация о заголовке скрыта из цитаты.
SuppressYear { get; set; }Возвращает или задает, будет ли информация о годе скрыта из цитаты.
virtual Type { get; }Получает тип поля Microsoft Word.
VolumeNumber { get; set; }Возвращает или задает номер тома, связанный с цитатой.

Методы

ИмяОписание
GetFieldCode()Возвращает текст между началом поля и разделителем полей (или концом поля, если разделитель отсутствует). Включаются как код поля, так и результат поля дочерних полей.
GetFieldCode(bool)Возвращает текст между началом поля и разделителем полей (или концом поля, если разделитель отсутствует).
Remove()Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля — последний child его родительского узла, возвращает его родительский абзац. Если поле уже удалено, возвращаетнулевой .
Unlink()Выполняет отмену связи поля.
Update()Выполняет обновление поля. Выдает исключение, если поле уже обновляется.
Update(bool)Выполняет обновление поля. Выдает исключение, если поле уже обновляется.

Примечания

Вставляет содержимоеИсточник элемент с указаннымЯрлык элемент, использующий библиографический стиль.

Примеры

Показывает, как работать с полями ЦИТАТА и БИБЛИОГРАФИЯ.

// Открываем документ, содержащий библиографические источники, которые мы можем найти в
// Microsoft Word через Ссылки -> Цитаты и библиография -> Управление источниками.
Document doc = new Document(MyDir + "Bibliography.docx");
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Text to be cited with one source.");

// Создайте ссылку, указав только номер страницы и автора указанной книги.
FieldCitation fieldCitation = (FieldCitation)builder.InsertField(FieldType.FieldCitation, true);

// Мы ссылаемся на источники, используя их имена тегов.
fieldCitation.SourceTag = "Book1";
fieldCitation.PageNumber = "85";
fieldCitation.SuppressAuthor = false;
fieldCitation.SuppressTitle = true;
fieldCitation.SuppressYear = true;

Assert.AreEqual(" CITATION  Book1 \\p 85 \\t \\y", fieldCitation.GetFieldCode());

// Создайте более подробную цитату, ссылающуюся на два источника.
builder.InsertParagraph();
builder.Write("Text to be cited with two sources.");
fieldCitation = (FieldCitation)builder.InsertField(FieldType.FieldCitation, true);
fieldCitation.SourceTag = "Book1";
fieldCitation.AnotherSourceTag = "Book2";
fieldCitation.FormatLanguageId = "en-US";
fieldCitation.PageNumber = "19";
fieldCitation.Prefix = "Prefix ";
fieldCitation.Suffix = " Suffix";
fieldCitation.SuppressAuthor = false;
fieldCitation.SuppressTitle = false;
fieldCitation.SuppressYear = false;
fieldCitation.VolumeNumber = "VII";

Assert.AreEqual(" CITATION  Book1 \\m Book2 \\l en-US \\p 19 \\f \"Prefix \" \\s \" Suffix\" \\v VII", fieldCitation.GetFieldCode());

// Мы можем использовать поле БИБЛИОГРАФИЯ для отображения всех источников в документе.
builder.InsertBreak(BreakType.PageBreak);
FieldBibliography fieldBibliography = (FieldBibliography)builder.InsertField(FieldType.FieldBibliography, true);
fieldBibliography.FormatLanguageId = "5129";
fieldBibliography.FilterLanguageId = "5129";
fieldBibliography.SourceTag = "Book2";

Assert.AreEqual(" BIBLIOGRAPHY  \\l 5129 \\f 5129 \\m Book2", fieldBibliography.GetFieldCode());

doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.CITATION.docx");

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

FieldChar Class FieldCollection Class