Compartir vía


OleDbCommand.CommandText Propiedad

Definición

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 StoredProcedureen , 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 TableDirecten , 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 Texten . 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.

Se aplica a

Consulte también