在 XPath 查詢中指定明確轉換函數 (SQLXML 4.0)

下列範例將示範如何在 XPath 查詢中指定明確轉換函數。這些範例中的 XPath 查詢是針對 SampleSchema1.xml 中包含的對應結構描述所指定。如需有關此範例結構描述的詳細資訊，請參閱＜XPath 範例的範例註解式 XSD 結構描述 (SQLXML 4.0)＞。

範例

number() 函數會將引數轉換成數字。

假設 ContactID 的值不是數值，下列查詢就會將 ContactID 轉換成數字並比較它與 4 這個值。然後，此查詢會傳回 ContactID 屬性為數值 4 之內容節點的所有 <Employee> 元素子系：

/child::Contact[number(attribute::ContactID)= 4]

您可以指定 attribute 軸的捷徑 (@)，而且因為 child 軸是預設值，因此可在查詢中省略：

/Contact[number(@ContactID) = 4]

在關聯式詞彙中，此查詢會傳回 ContactID 為 4 的員工。

複製範例結構描述程式碼，並將其貼至文字檔中。將檔案儲存為 SampleSchema1.xml。
建立下列範本 (ExplicitConversionA.xml)，並將其儲存在儲存 SampleSchema1.xml 的目錄中。
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    /Contact[number(@ContactID)=4]
  </sql:xpath-query>
</ROOT>
```
針對對應結構描述 (SampleSchema1.xml) 指定的目錄路徑相對於儲存範本的目錄。您也可以指定絕對路徑，例如：
```
mapping-schema="C:\MyDir\SampleSchema1.xml"
```
建立及使用 SQLXML 4.0 測試指令碼 (Sqlxml4test.vbs) 來執行範本。

如需詳細資訊，請參閱＜使用 ADO 執行 SQLXML 4.0 查詢＞。

這個範本執行的結果集如下：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Contact ContactID="4" LastName="Acevedo" FirstName="Humberto" Title="Sr." /> 
</ROOT>

string() 函數會將引數轉換成字串。

下列查詢會將 ContactID 轉換成字串並比較它與字串值 "4"。然後，此查詢會傳回 ContactID 具有字串值 "4" 之內容節點的所有 <Employee> 元素子系：

/child::Contact[string(attribute::ContactID)="4"]

您可以指定 attribute 軸的捷徑 (@)，而且因為 child 軸是預設值，因此可在查詢中省略：

/Contact[string(@ContactID)="4"]

就功能而言，這個函數與上一個範例查詢會傳回相同的結果，不過其評估是針對字串值而非數值 (亦即，數字 4) 進行。

複製範例結構描述程式碼，並將其貼至文字檔中。將檔案儲存為 SampleSchema1.xml。
建立下列範本 (ExplicitConversionB.xml)，並將其儲存在儲存 SampleSchema1.xml 的目錄中。
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    Contact[string(@ContactID)="4"]
  </sql:xpath-query>
</ROOT>
```
針對對應結構描述 (SampleSchema1.xml) 指定的目錄路徑相對於儲存範本的目錄。您也可以指定絕對路徑，例如：
```
mapping-schema="C:\MyDir\SampleSchema1.xml"
```
建立及使用 SQLXML 4.0 測試指令碼 (Sqlxml4test.vbs) 來執行範本。

如需詳細資訊，請參閱＜使用 ADO 執行 SQLXML 4.0 查詢＞。

以下為範本執行的結果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Contact ContactID="4" LastName="Acevedo" FirstName="Humberto" Title="Sr." /> 
</ROOT>