XML 模板讓你能在一份文件中同時指定 SQL 查詢與 XPath 查詢,是 SQL Server 對 XML 支援的重要一環。以下說明模板的一般形式與各元素、屬性的用途。
<ROOT xmlns:sql="urn:schemas-microsoft-com:XML-sql"
sql:xsl='XSL FileName'>
<sql:header>
<sql:param>..</sql:param>
<sql:param>..</sql:param>...n
</sql:header>
<sql:query>
sql statement(s)
</sql:query>
<sql:xpath-query mapping-schema="SchemaFileName.XML">
XPath query
</sql:xpath-query>
</ROOT>
模板中的元素全都是選用性的。header、param、query、xpath-query 等元素與 mapping-schema 屬性都定義在 sql 命名空間中,因此必須宣告 xmlns:sql="urn:schemas-microsoft-com:XML-sql";命名空間的名稱可自訂,sql 只是一個別名。
<ROOT>:提供結果 XML 文件的單一頂層(根)元素,名稱可任取。
<sql:header>:用來保存所有標題值,目前僅能在此放入 <sql:param>。作為容器,它讓你能集中定義多個參數,使處理更有效率。
<sql:param>:定義在模板內傳入查詢的參數,每個 param 對應一個參數,可在 header 中定義多個。
<sql:query>:指定 SQL 查詢,模板中可包含多個。
<sql:xpath-query>:指定 XPath 查詢。由於 XPath 是在帶批注的 XDR 架構上執行,必須以 mapping-schema 屬性指定架構檔名。
sql:xsl:指定要套用於結果 XML 的 XSL 樣式表,可為相對或絕對路徑;相對路徑相對於與 template 虛擬名稱關聯的目錄。例如目錄為 C:\Template 時,相對路徑 Xyz/MyXSL.xml 會對應到 C:\Template\Xyz\MyXSL.XML。
mapping-schema:標識帶批注的 XDR 架構,僅在執行 XPath 查詢時使用,同樣可為相對或絕對路徑。
每個 <sql:query> 或 <sql:XPath-query> 都代表獨立的事務。因此當模板中有多個這類標記時,若其中一個失敗,其他標記仍會繼續執行。
關於內容類型:若設定了 contenttype,Sqlisapi.dll 會把標題資訊回傳給瀏覽器;若未設定,urlmon 會依模板的第一個字元來判定。如果第一個字元是 < 或 Unicode 位元組順序標記(0xFFFE),便會以 text/XML 回傳並顯示結果,否則瀏覽器將看不到輸出。
在 URL 中指定模板前,必須先以「SQL Server 的 IIS 虛擬目錄管理」建立 template 類型的虛擬名稱。模板存放在與 template 虛擬名稱關聯的目錄或其子目錄中。若放在關聯目錄下,URL 形如 https://IISServer/nwind/TemplateVirtualName/TemplateFile.XML;若放在子目錄 xyz 中,則為 https://IISServer/nwind/TemplateVirtualName/xyz/TemplateFile.XML。
最後要留意:對於直接在 URL 中指定的 XPath 查詢,並不支援命名空間;若希望在 XPath 中使用命名空間,就必須改用模板。