Pengantar Penyedia SQLXMLOLEDB (SQLXML 4.0)

Penyedia SQLXMLOLEDB adalah penyedia OLE DB yang mengekspos fungsionalitas Microsoft SQLXML melalui ActiveX Data Objects (ADO). Namun, penyedia hanya dapat menjalankan perintah dalam mode "tulis ke aliran output" ADO. Penyedia SQLXMLOLEDB bukan penyedia set baris. Saat menjalankan perintah, Anda harus menentukan bendera adExecuteStream, yang mengarahkan ADO untuk menggunakan aliran output yang telah Anda tentukan.

Contoh berikut menunjukkan sintaks untuk perintah Jalankan tempat bendera adExecuteStream ditentukan:

Dim oTestCommand As New ADODB.Command  
...  
oTestCommand.Properties("Output Stream").Value = oTestStream  
oTestCommand.Execute , , adExecuteStream  
...  

Properti khusus Penyedia SQLXMLOLEDB

Penyedia SQLXMLOLEDB mengekspos properti koneksi khusus penyedia berikut.

Koneksi harta benda	Bawaan (jika ada)	Deskripsi
Penyedia Data		Menyediakan PROGID penyedia OLE DB tempat SQLXMLOLEDB menjalankan perintah. Dimulai di SQLXML 4.0 dan SQL Server 2005, penyedia ini terkandung dalam SQL Server Native Client; oleh karena itu, nilai properti ini dibatasi untuk "SQLNCLI11". Untuk informasi selengkapnya, lihat Pemrograman Klien Asli SQL Server.

Penyedia SQLXMLOLEDB mengekspos properti perintah khusus penyedia berikut.

Perintah harta benda	Bawaan (jika ada)	Deskripsi
Jalur Dasar	""	Menentukan jalur file dasar. Jalur file dasar digunakan untuk menentukan lokasi Bahasa Lembar Gaya XML (XSL) atau file skema pemetaan. Jalur file dasar juga digunakan untuk menyelesaikan jalur relatif XSL atau memetakan file skema yang telah ditentukan dalam properti XSL atau Skema Pemetaan. Untuk contoh di mana properti ini digunakan, lihat Mengeksekusi Kueri XPath (Penyedia SQLXMLOLEDB).
ClientSideXML	Tidak benar	Atur properti ini ke True jika Anda ingin proses konversi set baris ke XML terjadi pada klien alih-alih di server. Ini berguna ketika Anda ingin memindahkan beban performa ke tingkat tengah. Untuk contoh di mana properti ini digunakan, lihat Menjalankan Kueri SQL (Penyedia SQLXMLOLEDB) atau Menjalankan Templat yang Berisi Kueri SQL (Penyedia SQLXMLOLEDB).
Tipe Isi		Mengembalikan tipe konten output. Ini adalah properti READ ONLY. Properti ini menyediakan informasi ke browser tentang tipe konten (seperti TEXT/XML, TEXT/HTML, image/jpeg, dan sebagainya). Nilai properti ini menjadi bidang tipe isi yang dikirim ke browser sebagai bagian dari header HTTP, yang berisi tipe MIME (Ekstensi Email Internet Multiguna) dari dokumen yang dikirim sebagai isi.
Skema Pemetaan	NOL	Jika aplikasi klien menjalankan kueri XPath terhadap skema pemetaan (XDR atau XSD), properti ini digunakan untuk menentukan nama skema pemetaan. Jalur yang ditentukan dapat relatif (xyz/abc/MySchema.xml) atau absolut (C:\MyFolder\abc\MySchema.xml). Jika jalur relatif ditentukan, jalur dasar yang ditentukan oleh properti Jalur Dasar digunakan untuk menyelesaikan jalur relatif. Jika tidak ada jalur yang ditentukan dalam properti Jalur Dasar, jalur relatif relatif terhadap direktori saat ini. Dalam menentukan nilai untuk properti Skema Pemetaan, Anda dapat menentukan jalur direktori lokal atau URL (http://...). Jika Anda menentukan URL, Anda harus mengonfigurasi WinHTTP untuk mengakses server HTTP dan HTTPS melalui server proksi. Anda dapat melakukan ini dengan menjalankan utilitas Proxycfg.exe. Untuk informasi selengkapnya, lihat "Menggunakan Utilitas Konfigurasi Proksi WinHTTP" di Pustaka MSDN. Untuk contoh di mana properti ini digunakan, lihat Mengeksekusi Kueri XPath (Penyedia SQLXMLOLEDB).
namespace		Properti ini memungkinkan eksekusi kueri XPath yang menggunakan namespace layanan. Untuk contoh di mana properti ini digunakan, lihat Mengeksekusi Kueri XPath dengan Namespace (Penyedia SQLXMLOLEDB).
ss Stream Flags		Properti ini digunakan untuk menentukan jenis pembatasan keamanan tertentu. Misalnya, Anda mungkin tidak ingin mengizinkan referensi URL ke file atau jalur absolut ke file (seperti situs eksternal). Atau Anda mungkin tidak ingin memperbolehkan kueri dalam templat. Properti dapat ditetapkan nilai-nilai ini: 1 = STREAM_FLAGS_DISALLOW_URL 2 = STREAM_FLAGS_DISALLOW_ABSOLUTE_PATH 4 = STREAM_FLAGS_DISALLOW_QUERY 8 = STREAM_FLAGS_ DONTCACHEMAPPINGSCHEMA 16 = STREAM_FLAGS_DONTCACHETEMPLATE 32 = STREAM_FLAGS_DONTCACHEXSL Informasi tambahan tentang nilai-nilai ini disediakan dalam tabel berikutnya.
akar xml		Properti ini digunakan untuk menentukan tag akar untuk XML yang dihasilkan. Misalnya, jika Anda menjalankan kueri SQL terhadap database dan dokumen XML yang dihasilkan tidak memiliki elemen akar tunggal, nilai properti digunakan untuk menambahkan satu elemen akar ke dokumen. Untuk contoh di mana properti ini digunakan, lihat Mengeksekusi Kueri SQL (Penyedia SQLXMLOLEDB).
xsl		Properti ini digunakan untuk menentukan nama file XSL saat Anda ingin menerapkan transformasi XSL ke dokumen XML yang dikembalikan oleh kueri. Jalur yang ditentukan dapat relatif (xyz/abc/MyXSL.xsl) atau absolut (C:\MyFolder\abc\MyXSL.xsl). Jika jalur relatif ditentukan, jalur dasar yang ditentukan oleh properti Jalur Dasar digunakan untuk menyelesaikan jalur relatif. Jika tidak ada jalur yang ditentukan dalam properti Jalur Dasar, jalur relatif relatif terhadap direktori saat ini. Untuk contoh di mana properti ini digunakan, lihat Menerapkan Transformasi XSL (Penyedia SQLXMLOLEDB).

Tabel berikut berisi deskripsi nilai properti ss Stream Flags.

Nilai properti	Deskripsi
STREAM_FLAGS_DISALLOW_URL	URL tidak diterima untuk skema pemetaan atau XSL.
STREAM_FLAGS_DISALLOW_ABSOLTE_PATH	Jalur yang ditentukan untuk skema pemetaan atau untuk XSL harus relatif terhadap jalur dasar templat itu sendiri.
STREAM_FLAGS_DISALLOW_QUERY	Kueri tidak diperbolehkan dalam templat.
STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA	Skema pemetaan tidak di-cache. Nilai properti ini berguna selama fase pengembangan database, ketika skema database mengalami perubahan.
STREAM_FLAGS_DONTCACHETEMPLATE	Templat tidak di-cache.
STREAM_FLAGS_DONTCACHEXSL	XSL tidak di-cache.