Поделиться через


FieldChar Класс

Определение

Сложный символ поля.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — w:fldChar.

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "fldChar")]
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr(23, "fldChar")]
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("w:fldChar")]
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("w:fldChar")]
public class FieldChar : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))]
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class FieldChar : DocumentFormat.OpenXml.OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "fldChar")>]
type FieldChar = class
    inherit OpenXmlCompositeElement
type FieldChar = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr(23, "fldChar")>]
type FieldChar = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("w:fldChar")>]
type FieldChar = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("w:fldChar")>]
type FieldChar = class
    inherit TypedOpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))>]
type FieldChar = class
    inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.FormFieldData))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.NumberingChange))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type FieldChar = class
    inherit OpenXmlCompositeElement
Public Class FieldChar
Inherits OpenXmlCompositeElement
Public Class FieldChar
Inherits TypedOpenXmlCompositeElement
Наследование
Наследование
Атрибуты

Комментарии

[ISO/IEC 29500-1 1 издание]

fldChar (сложный символ поля)

Этот элемент указывает наличие сложного символа поля в текущем расположении родительского запуска. Сложный символ поля — это специальный символ, который отделяет начало и конец сложного поля или отделяет его коды полей от текущего результата поля.

Сложное поле определяется с помощью двух обязательных символов сложного поля: начального символа, указывающего начало сложного поля в содержимом документа; и символ конца, указывающий конец сложного поля. Этот синтаксис позволяет встраивать (или "вложенные") несколько полей в документе.

Кроме того, поскольку сложное поле может указывать как коды полей, так и текущий результат в документе, эти два элемента разделяются необязательным символом разделителя, который определяет конец кодов полей и начало содержимого поля. Пропуск этого символа должен использоваться для указания того, что содержимое поля является полностью кодами полей (т. е. поле не имеет результата).

[Пример. Рассмотрим следующее сложное определение поля в документе WordprocessingML:

<w:r>  
  <w:fldChar w:fldCharType="begin" />  
</w:r>  
<w:r>  
  <w:instrText>AUTHOR</w:instrText>  
</w:r>  
<w:r>  
  <w:fldChar w:fldCharType="separate" />  
</w:r>  
<w:r>  
  <w:t>Rex Jaeschke</w:t>  
</w:r>  
<w:r>  
  <w:fldChar w:fldCharType="end" />  
</w:r>  

Три элемента fldChar указывают:

  • Начало поля с использованием значения атрибута типа start

  • Разделитель между кодами полей и результатами текущего поля, используя значение атрибута типа отдельного

  • Конец поля с использованием значения атрибута типа end

конец примера

Если сложный символ поля находится в неподходящем расположении в документе WordprocessingML, его присутствие должно игнорироваться, и при отображении в результирующем документе не должно быть ни одного поля. Кроме того, если сложное поле не закрыто до окончания истории документа, то не должно быть создано ни одного поля, и каждое отдельное выполнение обрабатывается так, как если бы символы поля не существовали (т. е. содержимое всего содержимого кода поля не должно отображаться, а результаты поля должны отображаться как литеральный текст).

[Пример. Рассмотрим следующий документ WordprocessingML:

<w:body>  
  <w:p>  
    <w:r>  
      <w:fldChar w:fldCharType="start" />  
    </w:r>  
    <w:r>  
      <w:instrText>AUTHOR</w:instrText>  
    </w:r>  
    <w:r>  
      <w:fldChar w:fldCharType="separate" />  
    </w:r>  
    <w:r>  
      <w:t>Rex Jaeschke</w:t>  
    </w:r>  
  </w:p>  
</w:body>  

Сложное поле технически неверно, так как в main истории документа не существует конечного символа. Результирующее содержимое должно интерпретироваться так, как будто символы поля не существуют, в результате чего в документе отображается только литеральный текст Rex Jaeschke . конец примера

Родительские элементы
r (§22.1.2.87); r (§17.3.2.25)
Дочерние элементы Вложенные запросы
ffData (свойства поля формы) §17.16.17

[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_FldChar) находится в §A.1. конечная заметка]

ISO/IEC29500: 2008.

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

FieldChar()

Инициализирует новый экземпляр класса FieldChar.

FieldChar(IEnumerable<OpenXmlElement>)

Инициализирует новый экземпляр класса FieldChar с указанными дочерними элементами.

FieldChar(OpenXmlElement[])

Инициализирует новый экземпляр класса FieldChar с указанными дочерними элементами.

FieldChar(String)

Инициализирует новый экземпляр класса FieldChar из внешнего XML-кода.

Свойства

ChildElements

Возвращает все дочерние узлы текущего элемента.

(Унаследовано от OpenXmlElement)
Dirty

Результат поля недействителен

Представляет следующий атрибут в схеме: w:грязное

ExtendedAttributes

Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента.

(Унаследовано от OpenXmlElement)
Features

IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны.

(Унаследовано от OpenXmlElement)
FieldCharType

Тип символа поля

Представляет следующий атрибут в схеме: w:fldCharType

FieldData

Данные настраиваемого поля.

Представляет следующий тег элемента в схеме: w:fldData.

FieldLock

Поле не должно быть пересчитано

Представляет следующий атрибут в схеме: w:fldLock

FirstChild

Получает первый дочерний элемент текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlCompositeElement)
FormFieldData

Свойства поля формы.

Представляет следующий тег элемента в схеме: w:ffData.

HasAttributes

Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты.

(Унаследовано от OpenXmlElement)
HasChildren

Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы.

(Унаследовано от OpenXmlCompositeElement)
InnerText

Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов.

(Унаследовано от OpenXmlCompositeElement)
InnerXml

Возвращает или задает разметку, представляющую только дочерние узлы текущего узла.

(Унаследовано от OpenXmlCompositeElement)
LastChild

Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет.

(Унаследовано от OpenXmlCompositeElement)
LocalName

Сложный символ поля.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — w:fldChar.

LocalName

Возвращает локальное имя текущего элемента.

(Унаследовано от OpenXmlElement)
MCAttributes

Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки.

(Унаследовано от OpenXmlElement)
NamespaceDeclarations

Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен.

(Унаследовано от OpenXmlElement)
NamespaceUri

Возвращает универсальный код ресурса (URI) пространства имен текущего элемента.

(Унаследовано от OpenXmlElement)
NumberingChange

Предыдущие свойства поля нумеровки.

Представляет следующий тег элемента в схеме: w:numberingChange.

OpenXmlElementContext

Возвращает openXmlElementContext текущего элемента.

(Унаследовано от OpenXmlElement)
OuterXml

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

(Унаследовано от OpenXmlElement)
Parent

Возвращает родительский элемент текущего элемента.

(Унаследовано от OpenXmlElement)
Prefix

Возвращает префикс пространства имен текущего элемента.

(Унаследовано от OpenXmlElement)
XmlQualifiedName

Возвращает полное имя текущего элемента.

(Унаследовано от OpenXmlElement)
XName

Возвращает полное имя текущего элемента.

(Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)

Добавляет объект в список заметок текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
AddChild(OpenXmlElement, Boolean)

Добавляет указанный элемент в элемент , если он является известным дочерним элементом. При этом элемент будет добавлен в правильное расположение в соответствии со схемой.

(Унаследовано от OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)

Добавляет объявление пространства имен в текущий узел.

(Унаследовано от OpenXmlElement)
Ancestors()

Перечисляет все предки текущего элемента.

(Унаследовано от OpenXmlElement)
Ancestors<T>()

Перечисляет только предки текущего элемента, имеющие указанный тип.

(Унаследовано от OpenXmlElement)
Annotation(Type)

Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
Annotation<T>()

Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
Annotations(Type)

Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
Annotations<T>()

Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)

Добавляет каждый элемент из списка элементов в конец списка дочерних элементов текущего элемента.

(Унаследовано от OpenXmlElement)
Append(OpenXmlElement[])

Добавляет каждый элемент из массива элементов в конец списка дочерних элементов текущего элемента.

(Унаследовано от OpenXmlElement)
AppendChild<T>(T)

Добавляет указанный элемент в конец списка дочерних узлов текущего элемента.

(Унаследовано от OpenXmlCompositeElement)
ClearAllAttributes()

Очищает все атрибуты, включая как известные, так и расширенные атрибуты.

(Унаследовано от OpenXmlElement)
Clone()

Создает дубликат текущего узла.

(Унаследовано от OpenXmlElement)
CloneNode(Boolean)

Создает дубликат этого узла.

Descendants()

Перечисляет все потомки текущего элемента.

(Унаследовано от OpenXmlElement)
Descendants<T>()

Перечисление всех потомков текущего элемента типа T.

(Унаследовано от OpenXmlElement)
Elements()

Перечисляет все дочерние элементы текущего элемента.

(Унаследовано от OpenXmlElement)
Elements<T>()

Перечисляет только дочерние элементы текущего элемента, имеющие указанный тип.

(Унаследовано от OpenXmlElement)
ElementsAfter()

Перечисляет все одноуровневые элементы, которые следуют за текущим элементом и имеют тот же родительский элемент, что и текущий элемент.

(Унаследовано от OpenXmlElement)
ElementsBefore()

Перечисляет все одноуровневые элементы, которые предшествуют текущему элементу и имеют тот же родительский элемент, что и текущий элемент.

(Унаследовано от OpenXmlElement)
GetAttribute(String, String)

Возвращает атрибут Open XML с указанным именем тега и URI пространства имен.

(Унаследовано от OpenXmlElement)
GetAttributes()

Возвращает список, содержащий копию всех атрибутов.

(Унаследовано от OpenXmlElement)
GetEnumerator()

Возвращает перечислитель, который выполняет итерацию по дочерней коллекции.

(Унаследовано от OpenXmlElement)
GetFirstChild<T>()

Находит первый дочерний элемент в типе T.

(Унаследовано от OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)

Вставляет указанный элемент сразу после указанного ссылочного элемента.

(Унаследовано от OpenXmlCompositeElement)
InsertAfterSelf<T>(T)

Вставляет указанный элемент сразу после текущего элемента.

(Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)

Вставляет указанный элемент по указанному индексу дочерних элементов текущего элемента.

(Унаследовано от OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)

Вставляет указанный элемент непосредственно перед указанным ссылочным элементом.

(Унаследовано от OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)

Вставляет указанный элемент непосредственно перед текущим элементом.

(Унаследовано от OpenXmlElement)
IsAfter(OpenXmlElement)

Определяет, отображается ли текущий элемент после указанного элемента в порядке документа.

(Унаследовано от OpenXmlElement)
IsBefore(OpenXmlElement)

Определяет, отображается ли текущий элемент перед указанным элементом в порядке документа.

(Унаследовано от OpenXmlElement)
LookupNamespace(String)

Разрешает префикс пространства имен в контексте текущего узла.

(Унаследовано от OpenXmlElement)
LookupPrefix(String)

Находит соответствующий префикс для URI пространства имен в текущем элементе область.

(Унаследовано от OpenXmlElement)
NextSibling()

Возвращает элемент OpenXmlElement, который сразу же следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
NextSibling<T>()

Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement.

(Унаследовано от OpenXmlElement)
PrependChild<T>(T)

Вставляет указанный элемент в начало списка дочерних узлов текущего элемента.

(Унаследовано от OpenXmlCompositeElement)
PreviousSibling()

Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
PreviousSibling<T>()

Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
Remove()

Удаляет текущий элемент из родительского элемента.

(Унаследовано от OpenXmlElement)
RemoveAllChildren()

Удаляет все дочерние элементы текущего элемента.

(Унаследовано от OpenXmlCompositeElement)
RemoveAllChildren<T>()

Удалите все дочерние элементы текущего элемента типа T.

(Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)

Удаляет заметки указанного типа из текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()

Удаляет заметки с указанным типом из текущего элемента OpenXmlElement.

(Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)

Удаляет атрибут из текущего элемента.

(Унаследовано от OpenXmlElement)
RemoveChild<T>(T)

Удаляет указанный дочерний элемент.

(Унаследовано от OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)

Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса.

(Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)

Заменяет один из дочерних элементов текущего элемента другим элементом OpenXmlElement.

(Унаследовано от OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)

Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute.

(Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)

Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute.

(Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)

Сохраняет текущий узел в указанном xmlWriter.

(Унаследовано от OpenXmlElement)

Явные реализации интерфейса

IEnumerable.GetEnumerator()

Сложный символ поля.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — w:fldChar.

(Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()

Возвращает перечислитель, который выполняет итерацию по дочерней коллекции.

(Унаследовано от OpenXmlElement)

Применяется к