SqlCommand.CommandText Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 StoredProcedure
en , 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.