Поделиться через


OracleCommand Класс

Определение

Внимание!

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

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

public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OracleCommand : 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
type OracleCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OracleCommand = class
    inherit DbCommand
    interface 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 Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements 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()
Устаревшие..

Освобождает все ресурсы, занятые модулем Component.

(Унаследовано от Component)
Dispose()
Устаревшие..

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

(Унаследовано от DbCommand)
Dispose(Boolean)
Устаревшие..

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от Component)
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 .

IDbCommand.CreateParameter()
Устаревшие..

Создает новый экземпляр объекта IDbDataParameter .

(Унаследовано от DbCommand)
IDbCommand.ExecuteReader()
Устаревшие..

Выполняет CommandText применительно к объекту Connection и создает IDataReader.

IDbCommand.ExecuteReader()
Устаревшие..

Выполняет CommandText применительно к объекту Connection и создает IDataReader.

(Унаследовано от DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)
Устаревшие..

Выполняет свойство CommandText применительно к свойству Connection и создает интерфейс IDataReader с помощью одного из значений CommandBehavior.

IDbCommand.ExecuteReader(CommandBehavior)
Устаревшие..

Выполняет CommandText применительно к объекту Connection и создает IDataReader с помощью одного из значений CommandBehavior.

(Унаследовано от DbCommand)
IDbCommand.Parameters
Устаревшие..

Возвращает набор IDataParameterCollection.

(Унаследовано от DbCommand)
IDbCommand.Transaction
Устаревшие..

Возвращает или задает контекст DbTransaction, в котором выполняется этот объект DbCommand.

(Унаследовано от DbCommand)

Применяется к

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