共用方式為

使用 sql：hide 隱藏元素和屬性

  • 發行項

適用於：SQL ServerAzure SQL 資料庫

針對 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 查詢

  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>