SqlCommand.CommandText Propiedad

Definición

Obtiene o establece la instrucción de Transact-SQL, el nombre de tabla o el procedimiento almacenado que se ejecutan en el origen de datos.

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

Valor de propiedad

Procedimiento almacenado o instrucción de Transact-SQL que se ejecuta. El valor predeterminado es una cadena vacía.

Implementaciones

Atributos

Ejemplos

En el ejemplo siguiente se crea y SqlCommand se establecen algunas de sus propiedades.

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

Comentarios

Cuando la CommandType propiedad se establece StoredProcedureen , la CommandText propiedad debe establecerse en el nombre del procedimiento almacenado. Es posible que el usuario tenga que usar la sintaxis de caracteres de escape si el nombre del procedimiento almacenado contiene caracteres especiales. El comando ejecuta este procedimiento almacenado cuando se llama a uno de los Execute métodos .

El proveedor de datos de Microsoft .NET Framework para SQL Server no admite el marcador de posición del signo de interrogación (?) para pasar parámetros a una instrucción Transact-SQL o a un procedimiento almacenado llamado por un comando de CommandType.Text. En este caso, se deben usar parámetros con nombre. Por ejemplo:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Para obtener más información, vea Configurar parámetros y tipos de datos de parámetros.

Se aplica a

Consulte también