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

Примеры

В следующем примере используется ExecuteReader метод OracleCommand, а также OracleDataReader и OracleConnectionдля выбора строк из таблицы.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetInt32(0) & ", " _
                   & reader.GetInt32(1))
            End While
        Finally
            ' always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Комментарии

Этот тип является устаревшим и будет удален в следующей версии платформа .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)	Устаревшие.. Инициализирует новый экземпляр класса OracleCommand текстом запроса.
OracleCommand(String, OracleConnection)	Устаревшие.. Инициализирует новый экземпляр класса OracleCommand с текстом запроса и объектом OracleConnection.
OracleCommand(String, OracleConnection, OracleTransaction)	Устаревшие.. Инициализирует новый экземпляр класса OracleCommand с заданным текстом запроса и объектами OracleConnection и OracleTransaction.

Свойства

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 .
Dispose()	Устаревшие.. Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от DbCommand)
Dispose(Boolean)	Устаревшие.. Освобождает неуправляемые ресурсы, используемые объектом DbCommand, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbCommand)
DisposeAsync()	Устаревшие.. Асинхронно размещает объект команды. (Унаследовано от DbCommand)
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)	Устаревшие.. Асинхронная версия ExecuteReader, которая выполняет команду для своего подключения, возвращая DbDataReader объект , который можно использовать для доступа к результатам. Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Унаследовано от DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Устаревшие.. Вызывает 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()	Устаревшие.. Создает готовую (или скомпилированную) версию команды в источнике данных.
PrepareAsync(CancellationToken)	Устаревшие.. Асинхронно создает подготовленную (или скомпилированную) версию команды в источнике данных. (Унаследовано от DbCommand)
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)

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

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