Sequence 項目繫結支援

發行項
02/28/2011

本主題專門說明舊有技術。應該使用下列建立 XML Web Service 及 XML Web Service 用戶端： Windows Communication Foundation.

.NET Framework 會提供 <sequence> 項目的繫結支援。

說明

從結構描述產生類別時，XML Schema Definition Tool (Xsd.exe) 會產生該類別的成員 (欄位或屬性)，其順序與列示於 <sequence> (或 <all>) 項目內的順序完全相同。但是從指定的類別執行個體產生結構描述時，成員的順序則會根據反映 (Reflection) 引擎將其傳回至序列化程式的順序來決定。此順序並未定義，並且是變動的。若要在產生的結構描述內確定順序，請依適當情況設定下列屬性 (Attribute) 類別的 Order 屬性 (Property)：XmlElementAttribute、XmlAnyElementAttribute 和 XmlArrayAttribute。在使用 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 會將值為 `0` 的 maxOccurs 解譯為 `1`，而將值大於 1 的 maxOccurs 值解譯為 `unbounded`。藉由具有可多次發生序列 (maxOccurs 大於 1 的序列) 的結構描述使用 Xsd.exe 時，請使用 /order 命令列選項。如需為何需要使用這項工具的詳細資訊，請參閱 MaxOccurs 屬性繫結支援屬性。
minOccurs	從 XML 結構描述文件產生原始程式碼時，如果 minOccurs 屬性已套用至 <sequence> 項目，Xsd.exe 會忽略該屬性。從類別產生 XML 結構描述文件時，Xsd.exe 不會指定 minOccurs 值，而是會還原成預設值 `1`。請參閱 MinOccurs 屬性繫結支援屬性。

Xsd.exe 公用程式忽略試圖提供唯一識別項的 id 屬性。

maxOccurs

如果是 <sequence> 項目，Xsd.exe 會將值為 0 的 maxOccurs 解譯為 1，而將值大於 1 的 maxOccurs 值解譯為 unbounded。

藉由具有可多次發生序列 (maxOccurs 大於 1 的序列) 的結構描述使用 Xsd.exe 時，請使用 /order 命令列選項。如需為何需要使用這項工具的詳細資訊，請參閱 MaxOccurs 屬性繫結支援屬性。

minOccurs

從 XML 結構描述文件產生原始程式碼時，如果 minOccurs 屬性已套用至 <sequence> 項目，Xsd.exe 會忽略該屬性。

從類別產生 XML 結構描述文件時，Xsd.exe 不會指定 minOccurs 值，而是會還原成預設值 1。

請參閱 MinOccurs 屬性繫結支援屬性。

可能父項目：<choice>、<complexType>、<extension>、<group>、<restriction>

可能子項目：<annotation>、<any>、<choice>、<element>、<group>