OleDbCommand.CommandText Tulajdonság

Definíció

Névtér:
System.Data.OleDb
Szerelvény:
System.Data.OleDb.dll
Szerelvény:
System.Data.dll
Csomag:
System.Data.OleDb v11.0.0-preview.4.26230.115
Forrás:
OleDbCommand.cs
Forrás:
OleDbCommand.cs
Forrás:
OleDbCommand.cs
Forrás:
OleDbCommand.cs

Lekéri vagy beállítja az SQL-utasítást vagy a tárolt eljárást az adatforrásban való végrehajtáshoz.

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

Tulajdonság értéke

String

A végrehajtandó SQL-utasítás vagy tárolt eljárás. Az alapértelmezett érték egy üres sztring.

Megvalósítás

CommandText
Attribútumok
DataSysDescriptionAttribute

Példák

Az alábbi példa létrehoz és OleDbCommand beállít néhány tulajdonságot.

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

Megjegyzések

CommandType A tulajdonság beállításakor StoredProcedurea tulajdonságot a CommandType tárolt eljárás nevére kell állítani. Előfordulhat, hogy a felhasználónak a feloldó karakter szintaxisát kell használnia, ha a tárolt eljárás neve speciális karaktereket tartalmaz. A parancs végrehajtja ezt a tárolt eljárást, amikor meghívja az egyik metódust Execute .

Ha CommandType be van állítva TableDirect, a CommandType tulajdonságot a elérni kívánt tábla vagy táblák nevére kell állítani. Előfordulhat, hogy a felhasználónak feloldó karakter szintaxist kell használnia, ha a névvel ellátott táblák bármelyike speciális karaktereket tartalmaz. Az elnevezett tábla vagy táblák összes sora és oszlopa vissza lesz adva, amikor meghívja az egyik metódust Execute .

Nem állíthatja be a , Connectionés CommandType a CommandTexttulajdonságokat, ha az aktuális kapcsolat végrehajtási vagy beolvasási műveletet hajt végre.

Az OLE DB.NET-szolgáltató nem támogatja a paraméterek SQL-utasításba vagy egy OleDbCommand által > által hívott tárolt eljárásba történő továbbításának elnevezett paramétereit, ha CommandTypeText értékre van állítva. Ebben az esetben a kérdőjel (?) helyőrzőt kell használni. Például:

SELECT * FROM Customers WHERE CustomerID = ?

Ezért az objektumok hozzáadásának OleDbParameter sorrendje OleDbParameterCollection közvetlenül megfelel a paraméter kérdőjel helyőrzőjének pozíciójának.

További információ: Paraméterek és paraméteradattípusok konfigurálása.

A következőre érvényes:

Lásd még