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
- Наследование
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере создается несколько экземпляров OracleParameterOracleParameterCollection внутри.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 с помощью Microsoft поставщика OLE DB для Oracle (MSDAORA) и ODBC.NET Framework Data Provider, используя предложение 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, 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 столбца. |
| OracleParameter(String, OracleType, Int32) |
Инициализирует новый экземпляр OracleParameter класса, использующего имя параметра, тип данных и длину. |
| OracleParameter(String, OracleType) |
Инициализирует новый экземпляр OracleParameter класса, использующего имя параметра и тип данных. |
Свойства
| Имя | Описание |
|---|---|
| DbType |
Возвращает или задает DbType параметр. |
| Direction |
Возвращает или задает значение, указывающее, является ли параметр возвращаемым значением только входных данных, только выходом, двунаправленным или возвращаемым параметром хранимой процедуры. |
| IsNullable |
Возвращает или задает значение, указывающее, принимает ли параметр значения NULL. |
| Offset |
Возвращает или задает смещение Value для свойства. |
| OracleType |
Возвращает или задает OracleType параметр. |
| ParameterName |
Возвращает или задает имя OracleParameterобъекта . |
| Precision |
Устаревшие..
Возвращает или задает максимальное количество цифр, используемых для представления Value свойства. |
| Scale |
Устаревшие..
Возвращает или задает число десятичных разрядов, для которых Value разрешено. |
| Size |
Возвращает или задает максимальный размер данных в байтах столбца. |
| SourceColumn |
Возвращает или задает имя исходного столбца, сопоставленного с DataSet и используемым для загрузки или возврата Value. |
| SourceColumnNullMapping |
Возвращает или задает значение, указывающее, является ли исходный столбец пустым. Это позволяет OracleCommandBuilder правильно создавать инструкции Update для столбцов, допускающих значение NULL. |
| SourceVersion |
Возвращает или задает значение, используемое при загрузке DataRowVersionValue. |
| 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) |