Sdílet prostřednictvím

OleDbCommand.CommandText Vlastnost

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.OleDb.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.OleDb v11.0.0-preview.2.26159.112
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs

Získá nebo nastaví příkaz SQL nebo uloženou proceduru ke spuštění ve zdroji dat.

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

Hodnota vlastnosti

String

Příkaz SQL nebo uložená procedura ke spuštění. Výchozí hodnota je prázdný řetězec.

Implementuje

CommandText
Atributy
DataSysDescriptionAttribute

Příklady

Následující příklad vytvoří OleDbCommand a nastaví některé jeho vlastnosti.

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

Poznámky

CommandType Pokud je vlastnost nastavena na StoredProcedure, CommandType vlastnost by měla být nastavena na název uložené procedury. Pokud název uložené procedury obsahuje speciální znaky, může být nutné použít syntaxi řídicích znaků. Příkaz spustí tuto uloženou proceduru Execute při volání jedné z metod.

Pokud CommandType je tato vlastnost nastavená TableDirectna hodnotu , CommandType měla by být nastavena na název tabulky nebo tabulek, ke které se má přistupovat. Pokud některá z pojmenovaných tabulek obsahuje nějaké speciální znaky, může být nutné použít syntaxi řídicích znaků. Při volání jedné z Execute metod se vrátí všechny řádky a sloupce pojmenované tabulky nebo tabulky.

Nelze nastavit Connection, CommandTypea CommandText vlastnosti, pokud aktuální připojení provádí operaci spuštění nebo načtení.

Zprostředkovatel ole DB.NET nepodporuje pojmenované parametry pro předávání parametrů do příkazu SQL nebo uloženou proceduru volanou při OleDbCommandCommandType nastavení na Texthodnotu . V tomto případě se musí použít zástupný symbol otazníku (?). Například:

SELECT * FROM Customers WHERE CustomerID = ?

Proto pořadí, ve kterém OleDbParameter jsou objekty přidány do OleDbParameterCollection musí přímo odpovídat pozici zástupného symbolu otazníku pro parametr.

Další informace naleznete v tématu Konfigurace parametrů a datových typů parametrů.

Platí pro

Viz také