OleDbCommand.CommandText Egenskap

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

Egenskapsvärde

SQL-instruktionen eller den lagrade procedur som ska köras. Standardvärdet är en tom sträng.

Implementeringar

Attribut

DataSysDescriptionAttribute

Exempel

I följande exempel skapas en OleDbCommand och en del av dess egenskaper anges.

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

Kommentarer

När egenskapen CommandType är inställd StoredProcedureCommandType på ska egenskapen anges till namnet på den lagrade proceduren. Användaren kan behöva använda escape-teckensyntax om namnet på den lagrade proceduren innehåller specialtecken. Kommandot kör den här lagrade proceduren när du anropar någon av Execute metoderna.

När CommandType är inställt på TableDirectCommandType ska egenskapen anges till namnet på tabellen eller tabellerna som ska nås. Användaren kan behöva använda escape-teckensyntax om någon av de namngivna tabellerna innehåller specialtecken. Alla rader och kolumner i den namngivna tabellen eller tabellerna returneras när du anropar någon av Execute metoderna.

Du kan inte ange Connectionegenskaperna , CommandTypeoch CommandText om den aktuella anslutningen utför en körnings- eller hämtningsåtgärd.

OLE DB.NET-providern stöder inte namngivna parametrar för att skicka parametrar till en SQL-instruktion eller en lagrad procedur som anropas av en OleDbCommand när CommandType är inställd på Text. I det här fallet måste platshållaren för frågetecken (?) användas. Ett exempel:

SELECT * FROM Customers WHERE CustomerID = ?

Därför måste den ordning i vilken OleDbParameter objekt läggs till OleDbParameterCollection i måste direkt motsvara positionen för frågetecknets platshållare för parametern.

Mer information finns i Konfigurera parametrar och parameterdatatyper.

Se även

• Arbeta med kommandon