Bagikan melalui

Membuat Bagian CDATA Menggunakan sql:use-cdata (SQLXML 4.0)

Berlaku untuk: SQL ServerAzure SQL Database

Di XML, bagian CDATA digunakan untuk menghindari blok teks yang berisi karakter yang jika tidak akan dikenali sebagai karakter markup.

Database di Microsoft SQL Server terkadang dapat berisi karakter yang diperlakukan sebagai karakter markup oleh pengurai XML; misalnya, tanda kurung sudut (< dan >), simbol kurang dari atau sama dengan (<=), dan ampersand (&) diperlakukan sebagai karakter markup. Namun, Anda dapat membungkus jenis karakter khusus ini di bagian CDATA untuk mencegahnya diperlakukan sebagai karakter markup. Teks dalam bagian CDATA diperlakukan oleh pengurai XML sebagai teks biasa.

Anotasi sql:use-cdata digunakan untuk menentukan bahwa data yang dikembalikan oleh SQL Server harus dibungkus dalam bagian CDATA (yaitu, menunjukkan apakah nilai dari kolom yang ditentukan oleh sql:field harus diapit di bagian CDATA). Anotasi sql:use-cdata hanya dapat ditentukan pada elemen yang memetakan ke kolom database.

Anotasi sql:use-cdata mengambil nilai Boolean (0 = false, 1 = true). Nilai yang dapat diterima adalah 0, 1, true, dan false.

Anotasi ini tidak dapat digunakan dengan jenis atribut sql:url-encode atau pada jenis atribut ID, IDREF, IDREFS, NMTOKEN, dan NMTOKENS.

Contoh

Untuk membuat sampel kerja menggunakan contoh berikut, Anda harus memenuhi persyaratan tertentu. Untuk informasi selengkapnya, lihat Persyaratan untuk Menjalankan Contoh SQLXML.

J. Menentukan sql:use-cdata pada elemen

Dalam skema berikut, sql:use-cdata diatur ke 1 (True) untuk<> dalam< elemen Alamat.> Akibatnya, data dikembalikan di bagian CDATA.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Address"   
               sql:relation="Person.Address"   
               sql:key-fields="AddressID" >  
   <xsd:complexType>  
        <xsd:sequence>  
          <xsd:element name="AddressID"  type="xsd:string" />  
          <xsd:element name="AddressLine1" type="xsd:string"   
                       sql:use-cdata="1" />  
        </xsd:sequence>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>
Untuk menguji sampel kueri XPath terhadap skema

  1. Salin kode skema di atas dan tempelkan ke dalam file teks. Simpan file sebagai UseCData.xml.

  2. Salin templat berikut dan tempelkan ke dalam file teks. Simpan file sebagai UseCDataT.xml di direktori yang sama tempat Anda menyimpan UseCData.xml.

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="UseCData.xml">  
        /Address[AddressID < 11]  
    </sql:xpath-query>  
</ROOT>

    Jalur direktori yang ditentukan untuk skema pemetaan (UseCData.xml) relatif terhadap direktori tempat templat disimpan. Jalur absolut juga dapat ditentukan, misalnya:

    mapping-schema="C:\SqlXmlTest\UseCData.xml"

  3. Buat dan gunakan Skrip Pengujian SQLXML 4.0 (Sqlxml4test.vbs) untuk menjalankan templat.

    Untuk informasi selengkapnya, lihat Menggunakan ADO untuk Menjalankan Kueri SQLXML 4.0.

Ini adalah kumpulan hasil parsial:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">   
  <Address>   
    <AddressID>1</CustomerID>   
    <AddressLine1>   
      <![CDATA[ 1970 Napa Ct.  ]]>   
    </AddressLine1>   
  </Address>  
  <Address>  
    <AddressLine1>   
      <![CDATA[ 9833 Mt. Dias Blv. ]]>   
    </AddressLine1>   
  </Address>  
  ...  
</ROOT>
  • Last updated on