SqlCommand.CommandText Eigenschap

Definitie

Naamruimte:
System.Data.SqlClient
Assembly:
System.Data.dll

Hiermee haalt u de Transact-SQL-instructie, tabelnaam of opgeslagen procedure op die moet worden uitgevoerd op de gegevensbron.

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

String

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

Implementeringen

CommandText
Kenmerken
DataSysDescriptionAttribute

Voorbeelden

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

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

Opmerkingen

Wanneer de CommandType eigenschap is ingesteld op StoredProcedure, moet de CommandText 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.

De Microsoft .NET Framework-Data Provider voor SQL Server biedt geen ondersteuning voor de tijdelijke aanduiding voor het vraagteken (?) voor het doorgeven van parameters aan een Transact-SQL-instructie of een opgeslagen procedure die wordt aangeroepen met een opdracht van CommandType.Text. In dit geval moeten benoemde parameters worden gebruikt. Voorbeeld:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Zie Parameters en parametergegevenstypen configureren voor meer informatie.

Van toepassing op

Zie ook