OleDbCommand.CommandText Eigenschap

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }

public override string CommandText { get; set; }

[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set

member this.CommandText : string with get, set

Public Property CommandText As String

Public Overrides Property CommandText As String

Waarde van eigenschap

De SQL-instructie of opgeslagen procedure die moet worden uitgevoerd. De standaardwaarde is een lege tekenreeks.

Implementeringen

Kenmerken

DataSysDescriptionAttribute

Voorbeelden

In het volgende voorbeeld wordt een OleDbCommand aantal eigenschappen gemaakt en ingesteld.

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

Opmerkingen

Wanneer de CommandType eigenschap is ingesteld op StoredProcedure, moet de CommandType eigenschap worden ingesteld op de naam van de opgeslagen procedure. De gebruiker moet mogelijk escape-tekensyntaxis gebruiken als de naam van de opgeslagen procedure speciale tekens bevat. Met de opdracht wordt deze opgeslagen procedure uitgevoerd wanneer u een van de Execute methoden aanroept.

Wanneer CommandType deze is ingesteld TableDirect, moet de CommandType eigenschap worden ingesteld op de naam van de tabel of tabellen die moeten worden geopend. De gebruiker moet mogelijk escape-tekensyntaxis gebruiken als een van de benoemde tabellen speciale tekens bevat. Alle rijen en kolommen van de benoemde tabel of tabellen worden geretourneerd wanneer u een van de Execute methoden aanroept.

U kunt de Connection, CommandTypeen CommandText eigenschappen niet instellen als de huidige verbinding een uitvoerings- of ophaalbewerking uitvoert.

De OLE DB.NET Provider biedt geen ondersteuning voor benoemde parameters voor het doorgeven van parameters aan een SQL-instructie of een opgeslagen procedure die wordt aangeroepen door een OleDbCommand wanneer CommandType is ingesteld op Text. In dit geval moet de tijdelijke aanduiding voor het vraagteken (?) worden gebruikt. Voorbeeld:

SELECT * FROM Customers WHERE CustomerID = ?

Daarom moet de volgorde waarin OleDbParameter objecten aan de OleDbParameterCollection parameter worden toegevoegd, rechtstreeks overeenkomen met de positie van de tijdelijke aanduiding voor het vraagteken voor de parameter.

Zie Parameters en parametergegevenstypen configureren voor meer informatie.

Zie ook

• Werken met opdrachten