SqlCommand.CommandText Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

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 override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Valor de propiedad

String

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

Ejemplos

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

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

}

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 de 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, consulte Configuración de parámetros.