Udostępnij za pośrednictwem


OleDbCommand.CommandText Właściwość

Definicja

Pobiera lub ustawia instrukcję SQL lub procedurę składowaną do wykonania w źródle danych.

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

Wartość właściwości

Instrukcja SQL lub procedura składowana do wykonania. Wartością domyślną jest ciąg pusty.

Implementuje

Atrybuty

Przykłady

Poniższy przykład tworzy obiekt OleDbCommand i ustawia niektóre z jego właściwości.

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

Uwagi

CommandType Gdy właściwość jest ustawiona na StoredProcedurewartość , CommandType właściwość powinna być ustawiona na nazwę procedury składowanej. Użytkownik może być zobowiązany do używania składni znaków ucieczki, jeśli nazwa procedury składowanej zawiera jakiekolwiek znaki specjalne. Polecenie wykonuje tę procedurę składowaną podczas wywoływania Execute jednej z metod.

Gdy CommandType jest ustawiona TableDirectCommandType wartość , właściwość powinna być ustawiona na nazwę tabeli lub tabel, do których ma być uzyskiwany dostęp. Użytkownik może być zobowiązany do używania składni znaków ucieczki, jeśli którakolwiek z nazwanych tabel zawiera znaki specjalne. Wszystkie wiersze i kolumny nazwanej tabeli lub tabel zostaną zwrócone po wywołaniu jednej z Execute metod.

Nie można ustawić Connectionwłaściwości , iCommandText, CommandTypejeśli bieżące połączenie wykonuje operację wykonywania lub pobierania.

Dostawca DB.NET OLE nie obsługuje nazwanych parametrów do przekazywania parametrów do instrukcji SQL lub procedury składowanej wywoływanej OleDbCommand przez parametr , gdy CommandType jest ustawiona na Textwartość . W tym przypadku należy użyć symbolu zastępczego znaku zapytania (?). Na przykład:

SELECT * FROM Customers WHERE CustomerID = ?

W związku z tym kolejność OleDbParameter dodawania obiektów do OleDbParameterCollection obiektu musi bezpośrednio odpowiadać pozycji symbolu zastępczego znaku zapytania dla parametru.

Aby uzyskać więcej informacji, zobacz Konfigurowanie parametrów i typów danych parametrów.

Dotyczy

Zobacz też