RecipientData Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Данные об одной записи источника данных.
Этот класс доступен в Office 2007 и более поздних версиях.
Когда объект сериализуется как xml, его полное имя — w:recipientData.
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "recipientData")]
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr(23, "recipientData")]
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("w:recipientData")]
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.SchemaAttr("w:recipientData")]
public class RecipientData : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))]
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class RecipientData : DocumentFormat.OpenXml.OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "recipientData")>]
type RecipientData = class
inherit OpenXmlCompositeElement
type RecipientData = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr(23, "recipientData")>]
type RecipientData = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("w:recipientData")>]
type RecipientData = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.SchemaAttr("w:recipientData")>]
type RecipientData = class
inherit TypedOpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))>]
type RecipientData = class
inherit OpenXmlCompositeElement
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.Active))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.ColumnIndex))>]
[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.UniqueTag))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type RecipientData = class
inherit OpenXmlCompositeElement
Public Class RecipientData
Inherits OpenXmlCompositeElement
Public Class RecipientData
Inherits TypedOpenXmlCompositeElement
- Наследование
- Наследование
- Атрибуты
Комментарии
[ISO/IEC 29500-1 1 издание]
recipientData (запись данных об одном источнике данных)
Этот элемент задает сведения об одной записи во внешнем источнике данных. Если запись должна быть объединена в объединенный документ, то в этой части не требуется никаких сведений об этой записи. Однако если данная запись не должна быть объединена с объединенным документом, значение уникального ключа для этой записи должно храниться в элементе uniqueTag в качестве дочернего элемента этого элемента (вместе с активным элементом), чтобы указать это исключение.
[Примечание. Это сопоставление необходимо вместо простого использования порядка элементов для соответствия индексам записей во внешнем источнике данных, так как записи могут быть добавлены или удалены из внешних источников данных, и должны быть предоставлены средства для поддержания данных внешней записи WordprocessingML, например, указанной в активном элементе (§17.14.1) и соответствующей записи внешних данных при повторном подключении документа WordprocessingML к внешнему источнику данных; порядок записей во внешнем источнике данных. Другими словами, этот элемент и его дочерние элементы позволяют объединенным документам WordprocessingML поддерживать связь между записями во внешних данных и записывать конкретные параметры WordprocessingML. конечная заметка]
[Пример. Рассмотрим объединенный документ WordprocessingML, который:
Подключено к указанному внешнему источнику данных, содержаву 3 записям; И
Приложение размещения настроило не заполнять объединенный документ записью, относящейся к Джону Смиту, во внешнем источнике данных.
Учтите также, что при первом подключении данного документа WordprocessingML к внешнему источнику данных запись Джона Смита была во второй записи в источнике данных.
Когда этот объединенный документ подключен к внешнему источнику данных, элемент recipientData можно использовать для хранения числа и значения столбца, содержащего уникальный ключ для каждой записи данных во внешнем источнике данных, включая имя Джона Смита. Этот параметр представлен с помощью следующего кода WordprocessingML для использования хэш-кодов в элементе recipientData для уникальной идентификации трех записей во внешнем источнике данных.
<w:recipientData>
<w:column w:val="1" />
<w:uniqueTag>
1408613399</w:uniqueTag>
</w:recipientData>
<w:recipientData>
<w:active w:val="0" />
<w:column w:val="1" />
<w:uniqueTag>
870254691</w:uniqueTag>
</w:recipientData>
<w:recipientData>
<w:column w:val="1" />
<w:uniqueTag>
1107777181</w:uniqueTag>
</w:recipientData>
Здесь первая, вторая (запись Джона Смита) и третья записи в указанном источнике данных, уникальные значения ключа которых 1408613399, 870254691 и 1107777181 были связаны с данными получателя с помощью активного элемента, чтобы указать, что запись, связанная с данной записью (запись Джона Смита), не должна использоваться для заполнения объединенного документа WordprocessingML.
При наличии этой связи, если четвертая запись добавляется в указанный внешний источник данных выше записи Джона Смита, когда данный объединенный документ WordprocessingML повторно подключается к внешнему источнику данных, приложение размещения по-прежнему знает, что запись Джона Смита не должна использоваться для заполнения объединенного документа WordprocessingML, так как она связана с его уникальным значением ключа и не зависит от порядкового положения данной записи во внешней источник данных. конец примера
Родительские элементы |
---|
Корневой элемент части данных получателя слияния почты WordprocessingML; recipients (§17.14.29) |
Дочерние элементы | Вложенные запросы |
---|---|
active (запись включена в слияние) | §17.14.1 |
column (индекс столбца, содержащего уникальные значения для записи) | §17.14.7 |
uniqueTag (уникальное значение для записи) | §17.14.35 |
[Примечание. Определение xml-схемы W3C для модели содержимого этого элемента (CT_RecipientData) находится в §A.1. конечная заметка]
ISO/IEC29500: 2008.
Конструкторы
RecipientData() |
Инициализирует новый экземпляр класса RecipientData. |
RecipientData(IEnumerable<OpenXmlElement>) |
Инициализирует новый экземпляр класса RecipientData указанными дочерними элементами. |
RecipientData(OpenXmlElement[]) |
Инициализирует новый экземпляр класса RecipientData указанными дочерними элементами. |
RecipientData(String) |
Инициализирует новый экземпляр класса RecipientData из внешнего XML-кода. |
Свойства
Active |
Запись включается в слияние. Представляет следующий тег элемента в схеме: w:active. |
ChildElements |
Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement) |
ColumnIndex |
Индекс столбца, содержащего уникальные значения для записи. Представляет следующий тег элемента в схеме: w:column. |
ExtendedAttributes |
Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement) |
Features |
IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement) |
FirstChild |
Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement) |
HasAttributes |
Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement) |
HasChildren |
Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement) |
InnerText |
Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement) |
InnerXml |
Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement) |
LastChild |
Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement) |
LocalName |
Данные об одной записи источника данных. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — w:recipientData. |
LocalName |
Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement) |
MCAttributes |
Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement) |
NamespaceDeclarations |
Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement) |
NamespaceUri |
Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
OpenXmlElementContext |
Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement) |
OuterXml |
Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement) |
Parent |
Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement) |
Prefix |
Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement) |
UniqueTag |
Уникальное значение для параметра Record. Представляет следующий тег элемента в схеме: w:uniqueTag. |
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:recipientData. (Унаследовано от OpenXmlElement) |
IEnumerable<OpenXmlElement>.GetEnumerator() |
Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement) |