Sdílet prostřednictvím


OleDbCommand.CommandText Vlastnost

Definice

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

Příkaz SQL nebo uložená procedura, která se má provést. Výchozí hodnota je prázdný řetězec.

Implementuje

Atributy

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 uživatel požádán o použití syntaxe řídicího znaku. Příkaz spustí tuto uloženou proceduru Execute při volání jedné z metod.

Pokud CommandType je vlastnost nastavená CommandType na TableDirect, 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 speciální znaky, může být uživatel požádán o použití syntaxe řídicího znaku. Při volání jedné z metod se vrátí všechny řádky a sloupce pojmenované Execute tabulky nebo tabulek.

Vlastnosti , CommandTypea CommandText nelze nastavitConnection, 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žené procedury volané objektem OleDbCommand , pokud CommandType je nastavena na Texthodnotu . V takovém případě je nutné použít zástupný symbol otazníku (?). Pří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 najdete v tématu Konfigurace parametrů a datových typů parametrů.

Platí pro

Viz také