OleDbCommand.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 SQL o el procedimiento almacenado que se va a ejecutar 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
Instrucción de SQL o procedimiento almacenado que se va a ejecutar. El valor predeterminado es una cadena vacía.
Implementaciones
- Atributos
Ejemplos
En el ejemplo siguiente se crea y OleDbCommand se establecen algunas de sus propiedades.
public void CreateMyOleDbCommand()
{
OleDbCommand command = new OleDbCommand();
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
Dim command As New OleDbCommand()
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
command.CommandTimeout = 20
End Sub
Comentarios
Cuando la CommandType propiedad se establece StoredProcedure
en , la CommandType 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 .
Cuando CommandType se establece TableDirect
en , la CommandType propiedad debe establecerse en el nombre de la tabla o las tablas a las que se va a tener acceso. Es posible que el usuario tenga que usar la sintaxis de caracteres de escape si alguna de las tablas con nombre contiene caracteres especiales. Todas las filas y columnas de la tabla o las tablas con nombre se devolverán al llamar a uno de los Execute
métodos.
No se pueden establecer las Connectionpropiedades , CommandTypey CommandText si la conexión actual está realizando una operación de ejecución o captura.
Ole DB.NET Provider no admite parámetros con nombre para pasar parámetros a una instrucción SQL o a un procedimiento almacenado llamado por cuando OleDbCommandCommandType se establece Text
en . En este caso, se debe usar el marcador de posición de signo de interrogación (?). Por ejemplo:
SELECT * FROM Customers WHERE CustomerID = ?
Por lo tanto, el orden en el que OleDbParameter se agregan objetos a OleDbParameterCollection debe corresponder directamente a la posición del marcador de posición del signo de interrogación para el parámetro .
Para obtener más información, consulte Configuración de parámetros y tipos de datos de parámetros.