OleDbCommand.CommandText Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 StoredProcedure
CommandType 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ığındaTableDirect
CommandType, ö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 Text
tarafı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.