OleDbCommand.CommandText Özellik

Tanım

Veri kaynağında yürütülecek SQL deyimini veya saklı yordamı 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

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

Uygulamalar

Öznitelikler

Örnekler

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

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Açıklamalar

CommandType özelliği olarak StoredProcedureCommandType 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.

CommandType olarak ayarlandığındaTableDirectCommandType, özelliği erişilecek tablonun veya tabloların adına ayarlanmalıdır. Adlandırılmış tablolardan herhangi biri özel karakterler içeriyorsa, kullanıcının kaçış karakteri söz dizimini kullanması gerekebilir. Yöntemlerden birini çağırdığınızda adlandırılmış tablonun veya tabloların Execute tüm satırları ve sütunları döndürülür.

Geçerli bağlantı bir yürütme veya getirme işlemi gerçekleştiriyorsa , CommandTypeve CommandText özelliklerini ayarlayamazsınızConnection.

OLE DB.NET Sağlayıcısı, bir SQL Deyimine parametre geçirmek için adlandırılmış parametreleri veya olarak ayarlandığında Texttarafından çağrılan saklı OleDbCommandCommandType yordamı desteklemez. Bu durumda soru işareti (?) yer tutucusu kullanılmalıdır. Örnek:

SELECT * FROM Customers WHERE CustomerID = ?

Bu nedenle, nesnelerin öğesine OleDbParameterCollection eklenme sırasıOleDbParameter, parametrenin soru işareti yer tutucusunun konumuna doğrudan karşılık gelir.

Daha fazla bilgi için bkz. Parametreleri ve Parametre Veri Türlerini Yapılandırma.

Şunlara uygulanır

Ayrıca bkz.