SqlCommand.CommandText Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Public 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.

Uygulamalar

CommandText
Öznitelikler
DataSysDescriptionAttribute

Örnekler

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

public void CreateCommand()
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

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 ve Parametre Veri Türlerini Yapılandırma.

Şunlara uygulanır

Ayrıca bkz.