sequence 元素绑定支持

本主题专门介绍一项旧有技术。现在应通过使用以下链接来创建 XML Web 服务和 XML Web 服务客户端: Windows Communication Foundation.

.NET Framework 为 <sequence> 元素提供绑定支持。

说明

当从架构生成类时,XML Schema Definition Tool (Xsd.exe) 将按照 <sequence>(或 <all>)元素中列出的准确顺序生成类的成员(字段或属性)。但是当从给定的类实例生成架构时,成员的顺序取决于反射引擎将它们返回到序列化程序的顺序。该顺序没有定义,是可变的。若要确保所生成架构的序列顺序,请对以下特性类的 Order 属性进行适当设置:XmlElementAttributeXmlAnyElementAttributeXmlArrayAttribute。当使用 xsd.exe 工具从架构生成类时,您可以使用 /order 命令行开关来自动生成 Order 属性。

<sequence> 元素提供使用 <element> XSD 元素或其他某些 XSD 元素定义的元素的有序分组。相反,all 元素绑定支持 元素提供 <sequence> 元素可以包含的元素子集的无序分组。

当从 XML 架构文档生成源代码时,Xsd.exe 实用工具会按与 <sequence> 元素内容相同的顺序或按 <all> 元素的顺序生成公共字段。

当基于程序集中的一组类生成 XML 架构文档时,Xsd.exe 会按类的公共字段在类中的出现顺序,将这些字段转换为出现在 <sequence> 元素下的相应元素。

假设复杂类型中的元素应按顺序出现,而不是无序出现。

可能的特性 绑定支持

id

Xsd.exe 实用工具会忽略旨在提供唯一标识符的 id 特性。

maxOccurs

对于 <sequence> 元素,Xsd.exe 将 maxOccurs 的值 0 解释为 1,将大于 1 的 maxOccurs 值解释为 unbounded

将 Xsd.exe 用于具有多个发生序列(maxOccurs 大于 1 的序列)的架构时,请使用 /order 命令行选项。有关为什么需要此选项的更多信息,请参见 maxOccurs 特性绑定支持特性。

minOccurs

当从 XML 架构文档生成源代码时,Xsd.exe 会忽略应用于 <sequence> 元素的 minOccurs 特性。

当基于类生成 XML 架构文档时,Xsd.exe 不指定 minOccurs 值,而是恢复为默认值 1

请参见 minOccurs 特性绑定支持 特性。

可能的父元素:<choice><complexType><extension><group><restriction>

可能的子元素:<annotation><any><choice><element><group>

另请参见

参考

XmlSchemaSequence