使用 sql:hide 來隱藏元素和屬性

針對 XSD 結構描述執行 XPath 查詢時，產生的 XML 文件會具有在結構描述中指定的元素和屬性。您可以使用 sql:hide 註解來指定某些元素和屬性要在結構描述中隱藏。當查詢的選取準則需要結構描述中的特定元素或屬性，但是您不想要在產生的 XML 文件中傳回這些項目時，這樣做就很有用。

sql:hide 註解接受布林值 (0 = false，1 = true)。可接受的值為 0、1、true 和 false。

範例

若要使用下列範例建立工作範例，您必須符合某些需求。如需詳細資訊，請參閱＜執行 SQLXML 範例的需求＞。

A. 針對屬性指定 sql:hide

這則範例中的 XSD 結構描述包含 <Person.Contact> 元素以及 ContactID、FirstName 和 LastName 屬性。

<Person.Contact> 元素屬於複雜類型，因此它會對應至相同名稱的資料表 (預設對應)。<Person.Contact> 元素的所有屬性都屬於簡單類型，而且會對應至 AdventureWorks 資料庫中 Person.Contact 資料表內具有相同名稱的資料行。在結構描述中，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 查詢

1. 複製上述的結構描述程式碼，並將其貼到文字檔中。將檔案儲存為 Hide.xml。

2. 複製下列範本，並將其貼到文字檔中。將檔案儲存為 HideT.xml 並放在儲存 Hide.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"
   

3. 建立及使用 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> 元素指定了 sql:hide 的 XSD 結構描述：

<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>

針對此結構描述指定 XPath 查詢 (例如 /Customers[@CID="1"]) 時，產生的 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>