OracleParameter Класс

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Представляет параметр для объекта OracleCommand и (необязательно) его сопоставление с DataColumn. Этот класс не наследуется.

public ref class OracleParameter sealed : System::Data::Common::DbParameter, ICloneable

[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 DbParameter
    interface ICloneable
    interface IDbDataParameter
    interface IDataParameter

Public NotInheritable Class OracleParameter
Inherits DbParameter
Implements ICloneable

Наследование

Object

MarshalByRefObject

DbParameter

OracleParameter

Атрибуты

TypeConverterAttribute

Реализации

IDataParameter IDbDataParameter 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)