OracleCommand Класс

Определение

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

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Внимание

OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Представляет инструкцию SQL или хранимую процедуру для выполнения в базе данных. Этот класс не может быть унаследован.

public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable

[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable

[<System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable

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

Object

MarshalByRefObject

Component

DbCommand

OracleCommand

Атрибуты

ObsoleteAttribute

Реализации

ICloneable

Комментарии

Этот тип устарел и будет удален в будущей версии .NET Framework. Дополнительные сведения см. в статье Oracle и ADO.NET.

Класс OracleCommand предоставляет следующие методы для выполнения команд в источнике данных:

Элемент	Описание
ExecuteReader	Выполняет команды, возвращающие строки.
ExecuteOracleNonQuery	Выполняет инструкцию SQL и Connection возвращает количество затронутых строк.
ExecuteNonQuery	Выполняет такие команды, как SQL INSERT, DELETE, UPDATE и SET.
ExecuteScalar	Извлекает одно значение (например, статистическое значение) из базы данных в виде типа данных .NET Framework.
ExecuteOracleScalar	Извлекает одно значение (например, статистическое значение) из базы данных в качестве конкретного типа данных Oracle.

Можно сбросить CommandText свойство и повторно использовать OracleCommand объект.

Если выполнение команды приводит к неустранимой OracleExceptionошибке, OracleConnection может закрыться. Однако пользователь может повторно открыть подключение и продолжить.

Замечание

В отличие от объекта Command в других поставщиках данных .NET Framework (SQL Server, OLE DB и ODBC), OracleCommand объект не поддерживает CommandTimeout свойство. Установка времени ожидания команды не влияет, и возвращаемое значение всегда равно нулю.

Конструкторы

Имя	Описание
OracleCommand()	Устаревшие.. Инициализирует новый экземпляр OracleCommandобъекта .
OracleCommand(String, OracleConnection, OracleTransaction)	Устаревшие.. Инициализирует новый экземпляр OracleCommand класса с текстом запроса, OracleConnection объектом и объектом OracleTransaction.
OracleCommand(String, OracleConnection)	Устаревшие.. Инициализирует новый экземпляр OracleCommand класса с текстом запроса и OracleConnection объектом.
OracleCommand(String)	Устаревшие.. Инициализирует новый экземпляр OracleCommand класса с текстом запроса.

Свойства

Имя	Описание
CanRaiseEvents	Устаревшие.. Возвращает значение, указывающее, может ли компонент вызвать событие. (Унаследовано от Component)
CommandText	Устаревшие.. Возвращает или задает инструкцию SQL или хранимую процедуру для выполнения в базе данных.
CommandTimeout	Устаревшие.. Возвращает или задает время ожидания (в секундах), прежде чем завершать попытку выполнить команду и создать ошибку.
CommandType	Устаревшие.. Возвращает или задает значение, указывающее, как CommandText интерпретируется свойство.
Connection	Устаревшие.. Возвращает или задает используемый OracleConnection этим экземпляром экземпляра OracleCommand.
Container	Устаревшие.. Возвращает объект IContainer , содержащий Componentобъект . (Унаследовано от Component)
DbConnection	Устаревшие.. Возвращает или задает используемый DbConnection этим DbCommandпараметром. (Унаследовано от DbCommand)
DbParameterCollection	Устаревшие.. Возвращает коллекцию DbParameter объектов. (Унаследовано от DbCommand)
DbTransaction	Устаревшие.. Возвращает или задает объект DbTransaction , в котором выполняется этот DbCommand объект. (Унаследовано от DbCommand)
DesignMode	Устаревшие.. Возвращает значение, указывающее, находится ли текущий Component режим разработки. (Унаследовано от Component)
DesignTimeVisible	Устаревшие.. Возвращает или задает значение, указывающее, должен ли объект команды отображаться в настраиваемом элементе управления интерфейсом.
Events	Устаревшие.. Возвращает список обработчиков событий, подключенных к этому Component. (Унаследовано от Component)
Parameters	Устаревшие.. Возвращает OracleParameterCollection.
Site	Устаревшие.. Возвращает или задает ISite объект Component. (Унаследовано от Component)
Transaction	Устаревшие.. Возвращает или задает объект OracleTransaction , OracleCommand в пределах которого выполняется.
UpdatedRowSource	Устаревшие.. Возвращает или задает значение, указывающее, как Update метод должен применять результаты команды к объекту DataRow.

Методы

Имя	Описание
Cancel()	Устаревшие.. Пытается отменить выполнение объекта OracleCommand.
Clone()	Устаревшие.. Создает копию этого OracleCommand объекта.
CreateDbParameter()	Устаревшие.. Создает новый экземпляр DbParameter объекта. (Унаследовано от DbCommand)
CreateObjRef(Type)	Устаревшие.. Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateParameter()	Устаревшие.. Создает новый экземпляр OracleParameter объекта.
Equals(Object)	Устаревшие.. Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteDbDataReader(CommandBehavior)	Устаревшие.. Выполняет команду в отношении подключения, возвращая DbDataReader ее, которая может использоваться для доступа к результатам. (Унаследовано от DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Устаревшие.. Поставщики должны реализовать этот метод, чтобы обеспечить реализацию по умолчанию для ExecuteReader перегрузки. Реализация по умолчанию вызывает синхронный ExecuteReader() метод и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененного маркера отмены. Исключения, создаваемые ExecuteReader, будут передаваться через возвращаемое свойство "Исключение задачи". Этот метод принимает маркер отмены, который можно использовать для запроса на отмену операции раньше. Реализации могут игнорировать этот запрос. (Унаследовано от DbCommand)
ExecuteNonQuery()	Устаревшие.. Выполняет инструкцию SQL и Connection возвращает количество затронутых строк.
ExecuteNonQueryAsync()	Устаревшие.. Асинхронная версия ExecuteNonQuery(), которая выполняет команду в объекте подключения, возвращая количество затронутых строк. Вызывается ExecuteNonQueryAsync(CancellationToken) с помощью CancellationToken.None. (Унаследовано от DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Устаревшие.. Это асинхронная версия ExecuteNonQuery(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены может быть проигнорирован при необходимости. Реализация по умолчанию вызывает синхронный ExecuteNonQuery() метод и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененного маркера отмены. Исключения, создаваемые ExecuteNonQuery() путем передачи данных, будут передаваться с помощью возвращаемого свойства "Исключение задачи". Не вызывайте другие методы и свойства DbCommand объекта до завершения возвращаемой задачи. (Унаследовано от DbCommand)
ExecuteOracleNonQuery(OracleString)	Устаревшие.. Выполняет инструкцию SQL и Connection возвращает количество затронутых строк.
ExecuteOracleScalar()	Устаревшие.. Выполняет запрос и возвращает первый столбец первой строки в результирующем наборе, возвращаемом запросом в качестве типа данных Oracle. Дополнительные столбцы или строки игнорируются.
ExecuteReader()	Устаревшие.. Отправляет объект CommandText в Connection и создает объект OracleDataReader.
ExecuteReader(CommandBehavior)	Устаревшие.. Отправляет объект в CommandText и Connectionсоздает OracleDataReader одно из CommandBehavior значений.
ExecuteReaderAsync()	Устаревшие.. Асинхронная версия ExecuteReader, которая выполняет команду с его подключением, возвращая DbDataReader объект, который можно использовать для доступа к результатам. Вызывается ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) с помощью CancellationToken.None. (Унаследовано от DbCommand)
ExecuteReaderAsync(CancellationToken)	Устаревшие.. Асинхронная версия ExecuteReader, которая выполняет команду с его подключением, возвращая DbDataReader объект, который можно использовать для доступа к результатам. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Вызывается. (Унаследовано от DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Устаревшие.. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Вызывается. (Унаследовано от DbCommand)
ExecuteReaderAsync(CommandBehavior)	Устаревшие.. Асинхронная версия ExecuteReader, которая выполняет команду с его подключением, возвращая DbDataReader объект, который можно использовать для доступа к результатам. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Вызывается. (Унаследовано от DbCommand)
ExecuteScalar()	Устаревшие.. Выполняет запрос и возвращает первый столбец первой строки в результирующем наборе, возвращаемом запросом в виде типа данных .NET. Дополнительные столбцы или строки игнорируются.
ExecuteScalarAsync()	Устаревшие.. Асинхронная версия ExecuteScalar(), которая выполняет команду и возвращает первый столбец первой строки в первом возвращаемом результирующем наборе. Все остальные столбцы, строки и результирующие наборы игнорируются. Вызывается ExecuteScalarAsync(CancellationToken) с помощью CancellationToken.None. (Унаследовано от DbCommand)
ExecuteScalarAsync(CancellationToken)	Устаревшие.. Это асинхронная версия ExecuteScalar(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены может быть проигнорирован при необходимости. Реализация по умолчанию вызывает синхронный ExecuteScalar() метод и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененного маркера отмены. Исключения, создаваемые ExecuteScalar, будут передаваться через возвращаемое свойство "Исключение задачи". Не вызывайте другие методы и свойства DbCommand объекта до завершения возвращаемой задачи. (Унаследовано от DbCommand)
GetHashCode()	Устаревшие.. Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Устаревшие.. Возвращает объект, представляющий службу, предоставляемую Component или ее Container. (Унаследовано от Component)
GetType()	Устаревшие.. Возвращает Type текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Устаревшие.. Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Устаревшие.. Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
Prepare()	Устаревшие.. Создает подготовленную (или скомпилированную) версию команды в источнике данных.
ResetCommandTimeout()	Устаревшие.. Сбрасывает CommandTimeout свойство в значение по умолчанию.
ToString()	Устаревшие.. String Возвращает имя, содержащее имя , если таковое Componentимеется. Этот метод не должен быть переопределен. (Унаследовано от Component)

События

Имя	Описание
Disposed	Устаревшие.. Происходит при удалении компонента вызовом Dispose() метода. (Унаследовано от Component)

Явные реализации интерфейса

Имя	Описание
IDbCommand.Connection	Устаревшие.. Возвращает или задает используемый IDbConnection этим экземпляром экземпляра IDbCommand. (Унаследовано от DbCommand)
IDbCommand.CreateParameter()	Устаревшие.. Создает новый экземпляр IDbDataParameter объекта. (Унаследовано от DbCommand)
IDbCommand.ExecuteReader()	Устаревшие.. CommandText Выполняет против Connection и создает объектIDataReader. (Унаследовано от DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Устаревшие.. CommandText Выполняет против и Connectionсоздает IDataReader одно из CommandBehavior значений. (Унаследовано от DbCommand)
IDbCommand.Parameters	Устаревшие.. Возвращает IDataParameterCollection. (Унаследовано от DbCommand)
IDbCommand.Transaction	Устаревшие.. Возвращает или задает объект DbTransaction , в котором выполняется этот DbCommand объект. (Унаследовано от DbCommand)

См. также раздел

• Работа с командами