OracleCommand.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 la base de datos.
public:
property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public string CommandText { get; set; }
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Property CommandText As String
Public Overrides 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
Ejemplos
En el ejemplo siguiente se crea y OracleCommand se establecen algunas de sus propiedades.
public void CreateOracleCommand()
{
OracleCommand command = new OracleCommand();
command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo";
command.CommandType = CommandType.Text;
}
Public Sub CreateOracleCommand()
Dim command As New OracleCommand()
command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo"
command.CommandType = CommandType.Text
End Sub
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 métodos Execute.
El proveedor de datos de .NET Framework para Oracle no admite el marcador de posición de signo de interrogación (?) para pasar parámetros a una instrucción SQL llamada por un OracleCommand de CommandType.Text
. En este caso, se deben usar parámetros con nombre. Por ejemplo:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
Cuando se usan parámetros con nombre en una instrucción SQL llamada por un OracleCommand de CommandType.Text
, debe preceder al nombre del parámetro con dos puntos (:). Sin embargo, en un procedimiento almacenado o al hacer referencia a un parámetro con nombre en otro lugar del código (por ejemplo, al agregar OracleParameter objetos a la Parameters propiedad ), no preceda al parámetro con nombre con dos puntos (:). El proveedor de datos de .NET Framework para Oracle proporciona los dos puntos automáticamente.