CommandText (overridden)

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)


VB.NET
Public Overrides Property CommandText As String

C#
public override string CommandText { get; set; }


Gets or sets the Transact-SQL statement, table name or stored procedure to execute at the data source.

If a SqlException is generated by the method executing a SqlCommand, the SqlConnection remains open when the severity level is 19 or less. When the severity level is 20 or greater, the server usually closes the SqlConnection. However, the user can reopen the connection and continue.

Example: How to set the CommandText property

When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. The user may be required to use escape character syntax if the stored procedure name contains any special characters. The command executes this stored procedure when you call one of the Execute methods.

The Microsoft .NET Framework Data Provider for SQL Server does not support the question mark (?) placeholder for passing parameters to a Transact-SQL statement or a stored procedure called by a command of CommandType.Text. In this case, named parameters must be used.

Reusing SqlCommand object
The CommandText property can be reset, making it possible to reuse the SqlCommand object. To be able to execute a new command first close the SqlDataReader.