RecipientData 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
有关单一数据源记录的数据。
此类在 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.OpenXmlCompositeElementpublic 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 OpenXmlCompositeElementtype 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 OpenXmlCompositeElementPublic Class RecipientData
Inherits OpenXmlCompositeElementPublic Class RecipientData
Inherits TypedOpenXmlCompositeElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
recipientData (有关单一数据源记录) 的数据
此元素指定有关外部数据源中的单个记录的信息。 如果记录应合并到合并文档中，则在此部分中不需要有关该记录的信息。 但是，如果给定记录不应合并到合并文档中，则该记录的唯一键值应作为此元素的子元素存储在 uniqueTag 元素中， (活动元素) 来指示此排除项。
[注意：此映射必须取代仅使用元素顺序来对应于外部数据源中的记录索引，因为可以从外部数据源添加或删除记录，并且必须提供一种方法来维护 WordprocessingML 外部记录特定数据，如 active 元素 (§17.14.1 中指定的数据) 以及 WordprocessingML 文档重新连接到外部数据源时相应的外部数据记录;与外部数据源中的记录排序无关。 换句话说，此元素及其子元素使合并的 WordprocessingML 文档能够维护外部数据中的记录与记录特定的 WordprocessingML 参数之间的关系。 注释结束]
[示例：考虑合并的 WordprocessingML 文档，该文档：
已连接到包含三条记录的指定外部数据源;和
托管应用程序已配置为不使用外部数据源中与 John Smith 相关的记录填充合并文档。
另请注意，当给定的 WordprocessingML 文档首次连接到外部数据源时， John Smith 的记录位于数据源中的第二条记录中。
当此合并文档连接到外部数据源时，recipientData 元素可用于存储包含外部数据源（包括 John Smith）内每个数据记录的唯一键的列的数量和值。 此设置使用以下 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>
此处，第一个、第二个 (John Smith 记录) ，以及指定数据源中唯一键值1408613399、870254691和1107777181已通过活动元素与收件人数据关联的第三个记录，以指定与给定记录 (John Smith 记录关联的记录) 不得用于填充合并的 WordprocessingML 文档。
有了这些关联，如果将第四条记录添加到 John Smith 记录上方的给定外部数据源，则当给定合并的 WordprocessingML 文档重新连接到外部数据源时，托管应用程序仍然知道，不能使用 John Smith 的记录来填充合并的 WordprocessingML 文档，因为它通过其唯一键值关联，并且不依赖于给定记录在外部的序号位置数据源。 示例结束]
| 父元素 |
|---|
| WordprocessingML 邮件合并收件人数据部分的根元素;recipients (§17.14.29) |
| 子元素 | 第 |
|---|---|
| 活动 (记录包含在邮件合并) | §17.14.1 |
| 列 (包含记录) 唯一值的列索引 | §17.14.7 |
| uniqueTag (记录) 的唯一值 | §17.14.35 |
[注意：此元素的内容模型 (CT_RecipientData) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]
ISO/IEC29500：2008。
构造函数
| RecipientData() |
初始化 RecipientData 类的新实例。 |
| RecipientData(IEnumerable<OpenXmlElement>) |
使用指定的子元素初始化 RecipientData 类的新实例。 |
| RecipientData(OpenXmlElement[]) |
使用指定的子元素初始化 RecipientData 类的新实例。 |
| RecipientData(String) |
从外部 XML 初始化 RecipientData 类的新实例。 |
属性
| Active |
记录包含在邮件合并中。 表示架构中的以下元素标记：w：active。 |
| ChildElements |
获取当前元素的所有子节点。 (继承自 OpenXmlElement) |
| ColumnIndex |
包含 Record 的唯一值的列的索引。 表示架构中的以下元素标记：w：column。 |
| ExtendedAttributes |
获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement) |
| Features |
IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement) |
| FirstChild |
获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement) |
| HasAttributes |
获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement) |
| HasChildren |
获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement) |
| InnerText |
获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement) |
| InnerXml |
获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement) |
| LastChild |
获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 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 |
记录的唯一值。 表示架构中的以下元素标记：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) |
获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 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 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) |
| NextSibling<T>() |
获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement) |
| PrependChild<T>(T) |
在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement) |
| PreviousSibling() |
获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement) |
| PreviousSibling<T>() |
获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 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) |