Kelas Terkelola SQLXML - Objek SqlXmlCommand

Berlaku untuk: SQL ServerAzure SQL Database

Ini adalah konstruktor untuk objek SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Di mana cnString string koneksi ADO atau OLEDB yang mengidentifikasi server, database, dan informasi masuk-misalnya, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

Dalam string koneksi, Provider harus SQLOLEDB dan Data Provider tidak boleh disertakan dalam string penyedia).

Untuk sampel kerja, lihat Menjalankan Kueri SQL (Kelas Terkelola SQLXML).

Metode

Objek TheSqlXmlCommand mendukung beberapa metode, termasuk metode berikut untuk menjalankan perintah:

void ExecuteNonQuery()
Menjalankan perintah, tetapi tidak mengembalikan apa pun. Metode ini berguna jika Anda ingin menjalankan perintah nonkueri (yaitu, perintah yang tidak mengembalikan apa pun). Contohnya adalah menjalankan updategram atau DiffGram yang memperbarui rekaman tetapi tidak mengembalikan apa pun.

Stream ExecuteStream()
Mengembalikan objek Stream baru. Metode ini berguna saat Anda ingin hasil kueri dikembalikan kepada Anda di aliran baru. Untuk sampel kerja, lihat Menjalankan Kueri SQL (Kelas Terkelola SQLXML).

public void ExecuteToStream(Stream outputStream)
Menulis hasil kueri ke aliran yang sudah ada. Metode ini berguna ketika Anda memiliki aliran yang Anda perlukan hasilnya ditambahkan (misalnya, agar hasil kueri ditulis ke System.Web.HttpResponse.OutputStream). Untuk sampel kerja, lihat Menjalankan Kueri SQL (Kelas Terkelola SQLXML).

XmlReader ExecuteXmlReader()
Mengembalikan objek XmlReader. Anda dapat menggunakan metode ini untuk memanipulasi data di objek XmlReader secara langsung atau mencolokkan arsitektur System.Xml yang dapat diantai. Untuk informasi selengkapnya, lihat dokumentasi Microsoft .NET Framework. Untuk sampel kerja, lihat Menjalankan Kueri SQL dengan Menggunakan Metode ExecuteXMLReader.

Objek TheSqlXmlCommand juga mendukung metode tambahan ini:

SqlXmlParameter CreateParameter()
Membuat objek SqlXmlParameter. Anda dapat mengatur nilai untuk parameter Nama dan Nilai objek ini. Metode ini berguna jika Anda ingin meneruskan parameter ke perintah. Untuk sampel kerja, lihat Menjalankan Kueri SQL (Kelas Terkelola SQLXML).

void ClearParameters()
Menghapus parameter yang dibuat untuk objek perintah tertentu. Metode ini berguna jika Anda ingin menjalankan beberapa kueri pada objek perintah yang sama.

Properti

Objek SqlXmlCommand juga mendukung properti ini:

ClientSideXml
Saat diatur ke True, menentukan bahwa konversi set baris ke XML akan terjadi pada klien alih-alih di server. Properti ini berguna ketika Anda ingin memindahkan beban performa ke tingkat tengah. Properti ini juga memungkinkan Anda untuk membungkus prosedur tersimpan yang ada dengan FOR XML untuk mendapatkan output XML.

SchemaPath
Nama skema pemetaan bersama dengan jalur direktori (misalnya, C:\x\y\MySchema.xml). Properti ini berguna untuk menentukan skema pemetaan untuk kueri XPath. Jalur yang ditentukan dapat absolut atau relatif. Jika jalur relatif, jalur dasar yang ditentukan di Jalur Dasar digunakan untuk menyelesaikan jalur relatif. Jika tidak ada jalur dasar yang ditentukan, jalur relatif relatif terhadap direktori saat ini. Untuk sampel kerja, lihat Mengakses Fungsionalitas SQLXML di Lingkungan .NET.

XslPath
Nama file XSL bersama dengan jalur direktori. Jalur yang ditentukan dapat absolut atau relatif. Jika jalur relatif, jalur dasar yang ditentukan di Jalur Dasar digunakan untuk menyelesaikan jalur relatif. Jika tidak ada jalur dasar yang ditentukan, jalur relatif relatif terhadap direktori saat ini. Untuk sampel kerja, lihat Menerapkan Transformasi XSL (Kelas Terkelola SQLXML).

Jalur Dasar
Jalur dasar (jalur direktori). Properti ini berguna untuk menyelesaikan jalur relatif yang ditentukan untuk file XSL (dengan menggunakan properti XslPath), file skema pemetaan (dengan menggunakan properti SchemaPath), atau referensi skema eksternal dalam templat XML (ditentukan dengan menggunakan atribut skema pemetaan).

OutputEncoding
Menentukan pengodean untuk aliran yang dikembalikan saat perintah dijalankan. Properti ini berguna untuk meminta pengodean tertentu untuk aliran yang dikembalikan. Beberapa pengodean yang umum digunakan adalah UTF-8, ANSI, dan Unicode. UTF-8 adalah pengodean default.

Namaspace
Mengaktifkan eksekusi kueri XPath yang menggunakan namespace layanan. Untuk informasi selengkapnya tentang kueri XPath dengan namespace layanan, lihat Mengeksekusi Kueri XPath dengan Namespace (Kelas Terkelola SQLXML). Untuk sampel kerja, lihat Mengeksekusi Kueri XPath (Kelas Terkelola SQLXML).

RootTag
Menyediakan elemen akar tunggal untuk XML yang dihasilkan oleh eksekusi perintah. Dokumen XML yang valid memerlukan tag tingkat akar tunggal. Jika perintah yang dijalankan menghasilkan fragmen XML (tanpa satu elemen tingkat atas) Anda dapat menentukan elemen akar untuk XML yang dikembalikan. Untuk sampel kerja, lihat Menerapkan Transformasi XSL (Kelas Terkelola SQLXML).

CommandText
Teks perintah. Properti ini digunakan untuk menentukan teks perintah yang ingin Anda jalankan. Untuk sampel kerja, lihat Menjalankan Kueri SQL (Kelas Terkelola SQLXML).

CommandStream
Aliran perintah. Properti ini berguna jika Anda ingin menjalankan perintah dari file (misalnya, templat XML). Saat Anda menggunakan CommandStream, hanya nilai "Templat", "UpdateGram" dan "DiffGram"CommandType yang didukung. Untuk sampel kerja, lihat Menjalankan File Templat dengan Menggunakan Properti CommandStream.

CommandType
Mengidentifikasi jenis perintah. Properti ini digunakan untuk menentukan jenis perintah yang ingin Anda jalankan. Nilai dalam tabel berikut menentukan jenis perintah. Untuk sampel kerja, lihat Mengakses Fungsionalitas SQLXML di Lingkungan .NET.

Nilai	Deskripsi
SqlXmlCommandType.Sql	Menjalankan perintah SQL (misalnya, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Menjalankan perintah XPath (misalnya, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Menjalankan templat XML.
SqlXmlCommandType.TemplateFile	Menjalankan file templat pada jalur yang ditentukan.
SqlXmlCommandType.UpdateGram	Menjalankan updategram.
SqlXmlCommandType.Diffgram	Menjalankan DiffGram.

Lihat Juga

Objek SqlXmlParameter (Kelas Terkelola SQLXML)
Objek SqlXmlAdapter (Kelas Terkelola SQLXML)