SqlCommand.CommandText Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur pernyataan Transact-SQL, nama tabel, atau prosedur tersimpan untuk dijalankan di sumber data.
public:
virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Nilai Properti
Pernyataan Transact-SQL atau prosedur tersimpan untuk dijalankan. Defaultnya adalah string kosong.
Contoh
Contoh berikut membuat SqlCommand dan mengatur beberapa propertinya.
// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;
public class Form1 : Form
{
protected DataSet DataSet1;
protected DataGrid dataGrid1;
public void CreateCommand()
{
SqlCommand command = new SqlCommand();
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
command.CommandTimeout = 15;
command.CommandType = CommandType.Text;
}
// </Snippet1>
}
Keterangan
CommandType Ketika properti diatur ke StoredProcedure
, CommandText properti harus diatur ke nama prosedur tersimpan. Pengguna mungkin diharuskan untuk menggunakan sintaks karakter escape jika nama prosedur tersimpan berisi karakter khusus. Perintah menjalankan prosedur tersimpan ini saat Anda memanggil salah Execute
satu metode.
Penyedia Data microsoft .NET Framework untuk SQL Server tidak mendukung tempat penampung tanda tanya (?) untuk meneruskan parameter ke pernyataan Transact-SQL atau prosedur tersimpan CommandType.Text
yang dipanggil oleh perintah . Dalam hal ini, parameter bernama harus digunakan. Contohnya:
SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID
Untuk informasi selengkapnya, lihat Mengonfigurasi parameter.