通过

在 XPath 查询中指定轴 (SQLXML 4.0)

以下示例显示如何在 XPath 查询中指定轴。

这些示例中的 XPath 查询是针对 SampleSchema1.xml 中包含的映射架构指定的。有关该示例架构的信息，请参阅用于 XPath 示例的带批注的 XSD 架构示例 (SQLXML 4.0)。

示例

A. 检索上下文节点的子元素

以下 XPath 查询选择上下文节点的所有 <Contact> 子元素：

/child::Contact

在查询中，child 是轴，Contact 是节点测试（如果 Contact 为 <element> 节点则为 TRUE，因为 <element> 是与 child 轴关联的主节点类型）。

child 轴为默认轴。因此，可以将该查询编写为：

/Contact

针对该映射架构测试 XPath 查询

  1. 复制示例架构代码，并将它粘贴到文本文件中。将该文件另存为 SampleSchema1.xml。

  2. 创建以下模板 (XPathAxesSampleA.xml)，并将它保存在保存 SampleSchema1.xml 的目录中。

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    /Contact
  </sql:xpath-query>
</ROOT>

    为映射架构 (SampleSchema1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径，例如：

    mapping-schema="C:\MyDir\SampleSchema1.xml"

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

下面是执行该模板的部分结果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 
  <Contact ContactID="1" LastName="Achong" FirstName="Gustavo" Title="Mr." /> 
  <Contact ContactID="2" LastName="Abel" FirstName="Catherine" Title="Ms." /> 
  <Contact ContactID="3" LastName="Abercrombie" FirstName="Kim" Title="Ms." /> 
  <Contact ContactID="4" LastName="Acevedo" FirstName="Humberto" Title="Sr." />
  ...
</ROOT>

B. 检索上下文节点的孙级

以下 XPath 查询选择上下文节点的子元素 <Customer> 的所有 <Order> 子元素：

/child::Customer/child::Order

在查询中，child 是轴，Customer 和 Order 是节点测试（如果 Customer 和 Order 是 <element> 节点，则这些节点测试为 TRUE，因为 <element> 节点是 child 轴的主节点）。对于每个匹配 <Customer> 的节点，将匹配 <Orders> 的节点添加到结果。仅在结果集中返回 <Order>。

child 轴为默认轴。因此，可以将该查询指定为：

/Customer/Order

针对该映射架构测试 XPath 查询

  1. 复制示例架构代码，并将它粘贴到文本文件中。将该文件另存为 SampleSchema1.xml。

  2. 创建以下模板 (XPathAxesSampleB.xml)，并将它保存在以下目录中：

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    /Customer/Order
  </sql:xpath-query>
</ROOT>

    为映射架构 (SampleSchema1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径，例如：

    mapping-schema="C:\MyDir\SampleSchema1.xml"

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

下面是执行该模板的部分结果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Order SalesOrderID="Ord-43860" SalesPersonID="280" 
         OrderDate="2001-08-01T00:00:00" 
         DueDate="2001-08-13T00:00:00" 
         ShipDate="2001-08-08T00:00:00">
  <OrderDetail ProductID="Prod-729" UnitPrice="226.8571" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-732" UnitPrice="440.1742" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-738" UnitPrice="220.2496" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-753" UnitPrice="2576.3544" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-756" UnitPrice="1049.7528" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-758" UnitPrice="1049.7528" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-761" UnitPrice="503.3507" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-762" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-763" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-765" UnitPrice="503.3507" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-768" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-770" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  </Order>
   ...
</ROOT>

如果将 XPath 查询指定为 Customer/Order/OrderDetail，则从每个匹配 <Customer> 的节点该查询导航到它的 <Order> 元素。对于每个匹配 <Order> 的节点，该查询将节点 <OrderDetail> 添加到结果中。仅在结果集中返回 <OrderDetail>。

C. 使用 .. 指定 parent 轴

以下查询检索所有 <Order> 元素，它们的父 <Customer> 元素的 CustomerID 属性值为 1。该查询在谓词中使用 child 轴来查找 <Order> 元素的父级。

/child::Customer/child::Order[../@CustomerID="1"]

child 轴为默认轴。因此，可以将该查询指定为：

/Customer/Order[../@CustomerID="1"]

XPath 查询等效于：

/Customer[@CustomerID="1"]/Order.
注意注意

XPath 查询 /Order[../@CustomerID="1"] 将返回错误，因为 <Order> 的父级不存在。尽管在包含 <Order> 的映射架构中可能有元素，但是 XPath 不以它们开头，因此 <Order> 被视为文档中的顶级元素类型。

针对该映射架构测试 XPath 查询

  1. 复制示例架构代码，并将它粘贴到文本文件中。将该文件另存为 SampleSchema1.xml。

  2. 创建以下模板 (XPathAxesSampleC.xml)，并将它保存在以下目录中：

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    /Customer/Order[../@CustomerID="1"]
  </sql:xpath-query>
</ROOT>

    为映射架构 (SampleSchema1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径，例如：

    mapping-schema="C:\MyDir\SampleSchema1.xml"

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

下面是执行该模板的部分结果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Order SalesOrderID="Ord-43860" SalesPersonID="280" 
         OrderDate="2001-08-01T00:00:00" 
         DueDate="2001-08-13T00:00:00" 
         ShipDate="2001-08-08T00:00:00">
  <OrderDetail ProductID="Prod-729" UnitPrice="226.8571" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-732" UnitPrice="440.1742" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-738" UnitPrice="220.2496" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-753" UnitPrice="2576.3544" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-756" UnitPrice="1049.7528" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-758" UnitPrice="1049.7528" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-761" UnitPrice="503.3507" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-762" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-763" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-765" UnitPrice="503.3507" 
               OrderQty="2" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-768" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  <OrderDetail ProductID="Prod-770" UnitPrice="503.3507" 
               OrderQty="1" UnitPriceDiscount="0" /> 
  </Order>
   ...
</Order>
</ROOT>

D. 指定 attribute 轴

以下 XPath 查询选择 CustomerID 属性值为 1 的上下文节点的所有 <Customer> 子元素：

/child::Customer[attribute::CustomerID="1"]

在谓词 attribute::CustomerID 中，attribute 是轴，CustomerID 是节点测试（如果 CustomerID 是属性，则节点测试为 TRUE，因为 <attribute> 节点是 attribute 轴的主节点）。

可以指定 attribute 轴的快捷方式 (@)，因为 child 是默认轴，因此可以在查询中省略它：

/Customer[@CustomerID="1"]

针对该映射架构测试 XPath 查询

  1. 复制示例架构代码，并将它粘贴到文本文件中。将该文件另存为 SampleSchema1.xml。

  2. 创建以下模板 (XPathAxesSampleD.xml)，并将它保存在保存 SampleSchema1.xml 的目录中。

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:xpath-query mapping-schema="SampleSchema1.xml">
    child::Customer[attribute::CustomerID="1"]
  </sql:xpath-query>
</ROOT>

    为映射架构 (SampleSchema1.xml) 指定的目录路径是相对于模板保存目录的相对路径。也可以指定绝对路径，例如：

    mapping-schema="C:\MyDir\SampleSchema1.xml"

  3. 创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

    有关详细信息，请参阅使用 ADO 执行 SQLXML 4.0 查询。

下面是执行该模板的部分结果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <Customer CustomerID="1" SalesPersonID="280" 
            TerritoryID="1" AccountNumber="1" 
            CustomerType="S" Orders="Ord-43860 Ord-44501 Ord-45283 Ord-46042">
    <Order SalesOrderID="Ord-43860" SalesPersonID="280" 
           OrderDate="2001-08-01T00:00:00" 
           DueDate="2001-08-13T00:00:00" 
           ShipDate="2001-08-08T00:00:00">
       <OrderDetail ProductID="Prod-729" UnitPrice="226.8571" 
                    OrderQty="1" UnitPriceDiscount="0" /> 
       <OrderDetail ProductID="Prod-732" UnitPrice="440.1742" 
                    OrderQty="1" UnitPriceDiscount="0" /> 
       <OrderDetail ProductID="Prod-738" UnitPrice="220.2496" 
                    OrderQty="1" UnitPriceDiscount="0" /> 
      ... 
    </Order>
   ...
  </Customer>
</ROOT>