SqlCommand.CommandText Egenskap

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.SqlClient.dll
Sammansättning:
System.Data.dll
Källa:
System.Data.SqlClient.notsupported.cs

Hämtar eller anger den Transact-SQL-instruktion, tabellnamn eller lagrad procedur som ska köras på datakällan.

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

String

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

Implementeringar

CommandText
Attribut
DataSysDescriptionAttribute

Exempel

I följande exempel skapas en SqlCommand och vissa av dess egenskaper anges.

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

Kommentarer

När egenskapen CommandType är inställd StoredProcedureCommandText 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.

Microsoft .NET Framework-Data Provider för SQL Server stöder inte platshållaren för frågetecken (?) för att skicka parametrar till en Transact-SQL-instruktion eller en lagrad procedur som anropas av kommandot CommandType.Text. I det här fallet måste namngivna parametrar användas. Ett exempel:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Mer information finns i Konfigurera parametrar och parameterdatatyper.

Gäller för

Se även