Include 項目繫結支援

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

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

從 <include> 項目產生原始程式碼時，Xsd.exe 會將包含的 XSD 文件放置於透過 schemaLocation 屬性指定的絕對檔案系統路徑。

說明

<include> 項目與 <import> 項目相似。這兩個項目都會顯示為根 <schema> 項目的子項目，且必須出現在任何其他子項目之前。兩者會在個別的 <schema> 定義提取，通常是在另一個 .xsd 檔中定義。但其中有一項主要區別，如下所示：

• <import>：在透過 namespace 屬性指定的個別命名空間中匯入結構描述定義和宣告。

• <include>：在指定為現有 XML 結構描述定義之 targetNamespace 的同一命名空間中，包含其他結構描述定義和宣告。

使用 <include> 項目的 XML 結構描述定義，在語法上等同於直接出現包含定義的 XML 結構描述定義。

從組件的一組類別中產生 XML 結構描述文件時，Xsd.exe 只會為每個目標命名空間建立一個 .xsd 檔。換句話說，就是不會產生兩個都具有相同根 <schema> 項目之 targetNamespace 屬性值的 .xsd 檔。因此，絕對不會產生 <include> 項目。開發人員永遠都可以採用 <include> 項目，以手動方式將所產生的 .xsd 檔分成多個檔案。

從 XML 結構描述文件產生原始程式碼時，Xsd.exe 會辨識 <include> 項目。包含的 XSD 文件不能當做額外引數傳遞至 Xsd.exe，而是應該透過 schemaLocation 屬性來放置。屬性值必須是絕對檔案系統路徑。

下列範例顯示有效的 schemaLocation 值：

<xsd:include schemaLocation="c:\\projectRoot\\source\\xsd\\included1.xsd" />

注意：
當 schemaLocation 屬性出現在 <import> 項目中時，Xsd.exe 會忽略該屬性，改為針對 Xsd.exe 將任何匯入檔案指定為其他命令列引數。請參閱 Import 項目繫結支援。

可能的屬性	繫結支援
id	Xsd.exe 公用程式忽略試圖提供唯一識別項的 id 屬性。
schemaLocation	請參閱上述內容。

可能的父項目：<schema>

可能的子項目：<annotation>

另請參閱

參考

XmlSchemaInclude