本文示範如何在 Visual Studio 中建立一份與 XML 架構(XSD)關聯的 XML 文件,並說明如何反向從既有 XML 文件推導出架構。
在 Visual Basic 或 Visual C# 中建立新專案:從「檔案」選單指向「新增」後點擊「專案」開啟「新增專案」對話框,在「專案類型」窗格中依語言選擇「Visual Basic 專案」或「Visual C# 專案」,再選「Windows 應用程式」,命名為 XMLCustomerList 後按「確定」。
專案建立後會出現在方案總管中。從「專案」選單選擇「加入新項目」,在「加入新項目」對話框的「範本」區域選「XML 檔案」,命名為 CustomerList,按「開啟」。
同樣從「專案」→「加入新項目」,這次在範本中選「XML 架構」,命名為 CustomerListSchema 後開啟。
接下來建立一個代表五位郵遞區號的簡單型別元素。從工具箱的「XML 架構」頁籤把 simpleType 拖到設計面,將預設名稱 simpleType1 改為 postalCode;按 TAB 移到右側儲存格,從下拉清單選 positiveInteger;再按 TAB 到下一行,點下拉框——此時唯一的選項是 facet,這是因為簡單型別不能包含元素或屬性作為內容模型,只有 facet 可用來建構簡單型別。選擇 pattern,再按 TAB 到下一格輸入 \d{5}。
pattern facet 讓你可以輸入正則表達式,\d{5} 把 postalCode 型別的內容限制為五位數字。切換到 XML 檢視,根層級架構標記中應出現:
<xs:simpleType name="postalCode">
<xs:restriction base="xs:positiveInteger">
<xs:pattern value="\d{5}" />
</xs:restriction>
</xs:simpleType>
接著建立代表美國標準地址的 complexType。切到「架構」檢視,從工具箱拖入 complexType,把 complexType1 改名為 usAddress,不要為它指定資料型別。按 TAB 到下一行,下拉框中可看到多種可加入的元素選項,此處保留預設的元素設定即可,按 TAB 跳過。再按 TAB 到下一格輸入 Name,下一格把資料型別設為 string。
重複上述步驟,在 usAddress 中建立以下各列:
元素名稱 資料型別
Street string
City string
State string
Zip postalCode
請留意 Zip 元素的型別並非 string,而是前面自建的 postalCode 簡單型別——這正是自訂型別的價值所在。切到 XML 檢視可看到:
<xs:complexType name="usAddress">
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="Street" type="xs:string" />
<xs:element name="City" type="xs:string" />
<xs:element name="State" type="xs:string" />
<xs:element name="Zip" type="postalCode" />
</xs:sequence>
</xs:complexType>
型別定義完成後,就可以定義 XML 文件中實際的資料結構了。切到「架構」檢視,從工具箱拖入 element,把 element1 改名為 customer,不指定資料型別。按 TAB 到下一行輸入 CompanyName,下一格設為 string,再依序建立:
元素名稱 資料型別
ContactName string
Email string
Phone string
BillToAddress usAddress
ShipToAddress usAddress
BillToAddress 與 ShipToAddress 的型別都是前面建立的 usAddress 複雜型別。Email 與 Phone 也可以另外定義成簡單型別以便驗證格式。切到 XML 檢視,會看到 customer 元素的完整定義出現在根層級架構標記中。
為了在文件中容納多筆客戶資料,需要一個 customerList 元素包住所有 customer。從工具箱拖入 element,改名為 customerList,不指定型別;接著把先前建立的 customer 元素拖到 customerList 上完成綁定,設計面會以分層結構表示這層從屬關係。
在方案總管中雙擊 CustomerList.xml 開啟 XML 檢視,在「屬性」視窗中點選 targetSchema 屬性右側的儲存格,選擇 https://tempuri.org/CustomerListSchema.xsd。Visual Studio 會在 XML 檔中加入對架構的引用,並自動補上 <customerList> 標記。
因為架構已與文件關聯,XML 編輯器知道哪些元素是合法的,並會在「資料」檢視中提供格式化的表格。操作方式:在 XML 檢視中把游標放在 <customerList> 與 </customerList> 之間,輸入 < 後從提示清單選 Customer,輸入 > 結束標記;再輸入 < 選 CompanyName,輸入 > 後鍵入公司名稱(例如 Blue Yonder Airlines)。切換到「資料」檢視,在網格的「聯絡人姓名」欄位輸入 Nate Sun,把其他欄位補齊後切回 XML 檢視,就會看到資料已正確格式化為 XML。
注意:從既有 XML 文件推導架構時,所有資料型別的初始值都會被設為 string,因此必須依 XML 資料的實際內容需求自行調整型別。若需修改架構,同樣可以在「XML 設計器」中新增、編輯或移除元素。