Name 屬性繫結支援

發行項
01/04/2008

.NET Framework 會提供 name 屬性 (Attribute) 的繫結支援。

根據套用 name 屬性的項目而定，此屬性的值會對應到公用類別或欄位的名稱。套用適當的 ***Name 屬性，即可覆寫 Xsd.exe 產生 XSD 文件時所得到的名稱。

從 XSD 文件產生原始檔

name 屬性是當做從 XML 結構描述文件產生原始程式碼時，Xsd.exe 提供型別繫結的項目使用，如下所示：

<attribute>：提供代表該屬性之公用類別欄位的名稱。欄位會顯示具有 System.Xml.Serialization.XmlAttributeAttribute。

<complexType>：提供對應到複雜型別之類別的名稱。

<element>：提供代表該項目之公用類別欄位的名稱。如果 <element> 項目含有匿名的 <complexType> 定義，名稱就會變成對應到複雜型別之類別的名稱。

<simpleType>：提供對應到簡單型別之類別的名稱。.NET Framework 只允許透過 (a) 列舉字串型別和 (b) 建立當做屬性使用的清單，衍生簡單型別。

未嘗試轉換大小寫，以遵守程式碼撰寫慣例。例如，如果 <complexType> 項目的名稱屬性具有值 testInfo，則結果類別會命名為 testInfo，而不是首字大寫的 TestInfo。如果名稱與保留的關鍵字衝突，則所產生的名稱前面會加上 @ 符號。

.NET Framework 並未繫結至下列用來建立唯一性和參考完整性 (Referential Integrity) 的 XML 結構描述定義語言項目：<key>、<keyref> 和 <unique>。因此，便會忽略在這些項目中出現的 name 屬性。同樣地，<notation> 項目沒有型別繫結，因此也會忽略其中的 name 屬性。

由於 Xsd.exe 並未直接支援 <group> 和 <attributeGroup> 項目，而是將每個參考的內容展開至類別 (對應於包含參考的每個複雜型別)，因此會忽略群組或屬性群組名稱。