OracleCommand.CommandText Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает оператор SQL или хранимую процедуру, которую необходимо выполнить в базе данных.
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
Значение свойства
Инструкция или хранимая процедура SQL, подлежащая выполнению. Значение по умолчанию — пустая строка.
Реализации
Примеры
В следующем примере создается OracleCommand и задаются некоторые его свойства.
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
Комментарии
Если свойству CommandType присвоено значение StoredProcedure
, свойству CommandText должно быть присвоено имя хранимой процедуры. Пользователю может потребоваться использовать синтаксис escape-символов, если имя хранимой процедуры содержит специальные символы. Команда выполняет эту хранимую процедуру при вызове одного из методов Execute.
Поставщик данных платформа .NET Framework для Oracle не поддерживает заполнитель вопросительного знака (?) для передачи параметров в инструкцию SQL, вызываемую OracleCommand с CommandType.Text
помощью . В этом случае необходимо использовать именованные параметры. Пример:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
При использовании именованных параметров в инструкции SQL, вызываемой OracleCommandCommandType.Text
с помощью , имя параметра должно предшествовать двоеточию (:). Однако в хранимой процедуре или при ссылке на именованный параметр в другом месте кода (например, при добавлении OracleParameter объектов в свойство) не следует предшествовать Parameters именованному параметру двоеточием (:). Поставщик данных платформа .NET Framework для Oracle автоматически предоставляет двоеточие.