SqlCommand.CommandText Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Transact-SQL deyimini, tablo adını veya saklı yordamı veri kaynağında yürütülecek şekilde alır veya ayarlar.

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

Özellik Değeri

String

Yürütülecek Transact-SQL deyimi veya saklı yordam. Varsayılan değer boş bir dizedir.

Örnekler

Aşağıdaki örnek bir SqlCommand oluşturur ve özelliklerinden bazılarını ayarlar.

// <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>

}

Açıklamalar

CommandType özelliği olarak StoredProcedureCommandText ayarlandığında, özelliği saklı yordamın adına ayarlanmalıdır. Saklı yordam adında özel karakterler varsa, kullanıcının kaçış karakteri söz dizimini kullanması gerekebilir. Komut, yöntemlerden birini Execute çağırdığınızda bu saklı yordamı yürütür.

SQL Server için Microsoft .NET Framework Veri Sağlayıcısı, parametreleri bir Transact-SQL deyimine veya komutu tarafından çağrılan saklı yordama geçirmek için soru işareti (?) yer tutucusunu CommandType.Textdesteklemez. Bu durumda adlandırılmış parametreler kullanılmalıdır. Örnek:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Daha fazla bilgi için bkz . Parametreleri yapılandırma.