SqlCommand.CommandText Tulajdonság

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.SqlClient.dll
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

Lekéri vagy beállítja az adatforrásban végrehajtandó Transact-SQL utasítást, táblanevet vagy tárolt eljárást.

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ó Transact-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 egy SqlCommand és beállít néhány tulajdonságot.

public void CreateCommand()
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Megjegyzések

CommandType A tulajdonság beállításakor StoredProcedurea tulajdonságot a CommandText 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 .

A SQL Server Microsoft .NET-keretrendszer Data Provider nem támogatja a paraméterek Transact-SQL utasításnak vagy a CommandType.Text parancs által meghívott tárolt eljárásnak való továbbítására szolgáló kérdőjel (?) helyőrzőt. Ebben az esetben elnevezett paramétereket kell használni. Például:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

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

A következőre érvényes:

Lásd még