OracleParameter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет параметр для объекта OracleCommand и (необязательно) его сопоставление с DataColumn. Этот класс не наследуется.
public ref class OracleParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class OracleParameter sealed : System::Data::Common::DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))]
public sealed class OracleParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))]
public sealed class OracleParameter : System.Data.Common.DbParameter, ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))>]
type OracleParameter = class
inherit MarshalByRefObject
interface IDbDataParameter
interface IDataParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))>]
type OracleParameter = class
inherit DbParameter
interface ICloneable
interface IDbDataParameter
interface IDataParameter
Public NotInheritable Class OracleParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class OracleParameter
Inherits DbParameter
Implements ICloneable
- Наследование
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере создается несколько экземпляров OracleParameter с помощью OracleParameterCollection в .OracleDataAdapter Эти параметры используются для выбора данных из базы данных и их размещения в DataSet. В этом примере предполагается, что DataSet и OracleDataAdapter уже созданы с помощью соответствующей схемы, команд и соединения.
public void AddOracleParameters()
{
// ...
// create dataSet and adapter
// ...
adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith";
adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369;
adapter.Fill(dataSet);
}
Public Sub AddOracleParameters()
' ...
' create dataSet and adapter
' ...
adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith"
adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369
adapter.Fill(dataSet)
End Sub
Комментарии
В именах параметров регистр не учитывается.
При запросе базы данных Oracle с помощью поставщик OLE DB для Oracle (Майкрософт) (MSDAORA) и поставщика данных ODBC.NET Framework использование LIKE предложения для запроса значений в полях фиксированной длины может не возвращать все ожидаемые совпадения. Причина заключается в том, что, когда Oracle сопоставляет значения для полей фиксированной LIKE длины в предложении, он соответствует всей длине строки, включая все заполненные конечные пробелы. Например, если таблица в базе данных Oracle содержит поле с именем Field1, определенное как char(3), и вы введете значение a в строку этой таблицы, следующий код не вернет строку.
Dim queryString As String = "SELECT * FROM Table1 WHERE Field1 LIKE ?"
Dim command As OleDbCommand = New OleDbCommand(queryString, connection)
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a"
Dim reader As OleDbDataReader = command.ExecuteReader()
string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE ?";
OleDbCommand command = new OleDbCommand(queryString, connection);
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a";
OleDbDataReader reader = command.ExecuteReader();
Это связано с тем, что Oracle сохраняет значение столбца как "a" (заполнение "a" с конечными пробелами в фиксированной длине поля 3), которое Oracle не рассматривает как соответствие значению параметра "a" в случае LIKE сравнения полей фиксированной длины.
Чтобы устранить эту проблему, добавьте подстановочный знак процента ("%") к значению параметра ("a%") или используйте сравнение SQL = .
Конструкторы
| OracleParameter() |
Инициализирует новый экземпляр класса OracleParameter. |
| OracleParameter(String, Object) |
Инициализирует новый экземпляр класса OracleParameter, использующий имя параметра и объект OracleParameter. |
| OracleParameter(String, OracleType) |
Выполняет инициализацию нового экземпляра класса OracleParameter, использующего имя параметра и тип данных. |
| OracleParameter(String, OracleType, Int32) |
Выполняет инициализацию нового экземпляра класса OracleParameter, использующего имя параметра, тип данных и длину. |
| OracleParameter(String, OracleType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) |
Инициализирует новый экземпляр класса OracleParameter, использующий имя параметра, тип данных, длину, имя исходного столбца, направление параметра, точность чисел и другие свойства. |
| OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object) |
Выполняет инициализацию нового экземпляра класса OracleParameter, использующего имя параметра, тип данных, размер, направление, столбец источника, версию источника и другие свойства. |
| OracleParameter(String, OracleType, Int32, String) |
Выполняет инициализацию нового экземпляра класса OracleParameter, использующего имя параметра, тип данных, длину и имя столбца источника. |
Свойства
| DbType |
Возвращает или устанавливает тип DbType параметра. |
| Direction |
Возвращает или задает значение, указывающее, является ли параметр только входным, только выходным, двунаправленным или параметром, возвращаемым хранимой процедурой. |
| IsNullable |
Возвращает или задает значение, указывающее, принимает ли этот параметр значения NULL. |
| Offset |
Получает или задает смещение для свойства Value. |
| OracleType |
Возвращает или устанавливает тип OracleType параметра. |
| ParameterName |
Возвращает или задает имя таблицы для объекта OracleParameter. |
| Precision |
Устаревшие..
Возвращает или задает максимальное количество цифр, используемых для представления свойства Value. |
| Scale |
Устаревшие..
Возвращает или задает число десятичных разрядов, до которых вычисляется значение Value. |
| Size |
Возвращает или задает максимальный размер (в байтах) данных внутри столбца. |
| SourceColumn |
Возвращает или задает имя исходного столбца, сопоставленного DataSet и используемого для загрузки или возвращения значения Value. |
| SourceColumnNullMapping |
Возвращает или задает значение, показывающее, допускает ли исходный столбец значения NULL. Это позволяет OracleCommandBuilder правильно создавать инструкции Update для столбцов со значением NULL. |
| SourceVersion |
Возвращает или задает значение DataRowVersion, используемое при загрузке Value. |
| Value |
Возвращает или задает значение параметра. |
Методы
| CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
| ResetDbType() |
Сбрасывает тип, связанный с параметром OracleParameter. |
| ResetOracleType() |
Сбрасывает тип, связанный с параметром OracleParameter. |
| ToString() |
Возвращает строку, содержащую имя ParameterName. |
Явные реализации интерфейса
| ICloneable.Clone() |
Описание этого члена см. в разделе Clone(). |
| IDbDataParameter.Precision |
Указывает точность числовых параметров. (Унаследовано от DbParameter) |
| IDbDataParameter.Scale |
Описание этого члена см. в разделе Scale. (Унаследовано от DbParameter) |