使用 sql:hide 隐藏元素和属性

项目
03/06/2017

针对 XSD 架构执行 XPath 查询时，生成的 XML 文档具有在架构中指定的元素和属性。可以使用 sql:hide 批注来指定隐藏架构中的某些元素和属性。当查询的选择条件需要架构中的特定元素或属性，但是不希望在生成的 XML 文档中返回这些元素或属性时，该批注很有用。

sql:hide 批注采用布尔值（0 = FALSE，1 = TRUE）。可接受的值为 0、1、true 和 false。

示例

若要创建使用以下示例的工作示例，必须满足某些要求。有关详细信息，请参阅运行 SQLXML 示例的要求。

A. 对属性指定 sql:hide

此示例中的 XSD 架构由具有 <ContactID、FirstName 和 LastName 属性的 Person.Contact> 元素组成。

<Person.Contact> 元素属于复杂类型，因此映射到同名的表 (默认映射) 。 Person.Contact> 元素的所有属性<都是简单类型，并映射到 AdventureWorks 数据库的 Person.Contacttable 中具有相同名称的列。在架构中，批 sql:hide 注是在 ContactID 属性上指定的。针对此架构指定 XPath 查询时，不会在 XML 文档中返回 ContactID 。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Person.Contact" >  
     <xsd:complexType>  
       <xsd:attribute name="ContactID"  sql:hide="true" />   
       <xsd:attribute name="FirstName"   type="xsd:string" />   
       <xsd:attribute name="LastName"    type="xsd:string" />   
     </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

针对架构测试示例 XPath 查询

复制上面的架构代码，并将它粘贴到文本文件中。将文件另存为 Hide.xml。
复制以下模板，并将它粘贴到文本文件中。在保存 Hide.xml 的相同目录中将该文件另存为 HideT.xml。
```
<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="Hide.xml">  
        /Person.Contact[@ContactID="1"]  
    </sql:xpath-query>  
</ROOT>  
```
为映射架构 (Hide.xml) 指定的目录路径是保存模板目录的相对路径。也可以指定绝对路径，例如：
```
mapping-schema="C:\MyDir\Hide.xml"  
```
创建并使用 SQLXML 4.0 测试脚本 (Sqlxml4test.vbs) 执行该模板。

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

下面是结果集：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
   <Person.Contact FirstName="Gustavo" LastName="Achong" />   
</ROOT>

如果对元素指定 sql:hide，则该元素及其属性或子元素都不会出现在生成的 XML 文档中。下面是在 OD> 元素上<指定的另一个 XSD 架构sql:hide：

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:dt="urn:schemas-microsoft-com:datatypes"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  
  <xsd:annotation>  
    <xsd:documentation>  
      Sales.Customer-Sales.SalesOrderHeader-Sales.SalesOrderDetail Schema  
      Copyright 2004 Microsoft. All rights reserved.  
    </xsd:documentation>  
    <xsd:appinfo>  
      <sql:relationship name="CustomerOrder"  
         parent="Sales.Customer"  
                  parent-key="CustomerID"  
                  child-key="CustomerID"  
                  child="Sales.SalesOrderHeader" />  
       <sql:relationship name="OrderOrderDetails"  
                  parent="Sales.SalesOrderHeader"  
                  parent-key="SalesOrderID"  
                  child-key="SalesOrderID"  
                  child="Sales.SalesOrderDetail"/>  
    </xsd:appinfo>  
  </xsd:annotation>  
  
  <xsd:element name="Customers" sql:relation="Sales.Customer">  
    <xsd:complexType>  
      <xsd:sequence>  
        <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"   
                     maxOccurs="unbounded"   
                     sql:relationship="CustomerOrder">  
          <xsd:complexType>  
            <xsd:sequence>  
               <xsd:element name="OD" sql:relation="Sales.SalesOrderDetail"                                       maxOccurs="unbounded"                                       sql:relationship="OrderOrderDetails"                                       sql:hide="1">  
                  <xsd:complexType>  
                    <xsd:attribute name="SalesOrderID" type="xsd:string"/>  
                    <xsd:attribute name="ProductID" type="xsd:string"/>  
                  </xsd:complexType>  
               </xsd:element>  
            </xsd:sequence>  
          <xsd:attribute name="CustomerID" type="xsd:string"/>  
          <xsd:attribute name="OID" sql:field="SalesOrderID"   
                                    type="xsd:string"/>  
          <xsd:attribute name="OrderDate" type="xsd:date"/>   
        </xsd:complexType>  
      </xsd:element>  
    </xsd:sequence>  
    <xsd:attribute name="CID" sql:field="CustomerID"   
                                type="xsd:string"/>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

例如 /Customers[@CID="1"] ，当 XPath 查询 (为此架构指定) 时，生成的 XML 文档不包括 <OD> 元素及其子级，如以下部分结果所示：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <Customers CID="1">  
    <Order CustomerID="1" OID="43860" OrderDate="2001-08-01" />   
    <Order CustomerID="1" OID="44501" OrderDate="2001-11-01" />   
    <Order CustomerID="1" OID="45283" OrderDate="2002-02-01" />   
    <Order CustomerID="1" OID="46042" OrderDate="2002-05-01" />   
  </Customers>  
</ROOT>

通过

使用 sql:hide 隐藏元素和属性

示例

A. 对属性指定 sql:hide

针对架构测试示例 XPath 查询

其他资源