OleDbCommand Класс

Определение

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

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Наследование
OleDbCommand
Наследование
Наследование
Реализации

Примеры

В следующем примере для выбора строк из базы данных Access используются OleDbCommandOleDbConnectionстроки и OleDbDataAdapter строки. Затем возвращается заполнение DataSet . В этом примере передается инициализированная DataSetстрока подключения, строка запроса, которая является SQL инструкцией SELECT и строкой, которая является именем таблицы базы данных-источника.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Комментарии

При создании экземпляра OleDbCommand свойства чтения и записи задаются в качестве исходных значений. Список этих значений см. в конструкторе OleDbCommand.

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

Элемент Описание
ExecuteReader Выполняет команды, возвращающие строки. ExecuteReaderМожет не влиять на то, что вы хотите использовать для выполнения таких команд, как SQL инструкции SET.
ExecuteNonQuery Выполняет такие команды, как SQL инструкции INSERT, DELETE, UPDATE и SET.
ExecuteScalar Получает одно значение, например статистическое значение из базы данных.

Вы можете сбросить CommandText свойство и повторно использовать OleDbCommand объект. Однако необходимо закрыть OleDbDataReader перед выполнением новой или предыдущей команды.

Если неустранимый OleDbException (например, уровень серьезности SQL Server 20 или выше) создается методом, выполняющим объект OleDbCommand, OleDbConnectionсоединение может быть закрыто. Тем не менее, пользователь может опять открыть подключение и продолжить работу.

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

OleDbCommand()

Инициализирует новый экземпляр класса OleDbCommand.

OleDbCommand(String)

Инициализирует новый экземпляр класса OleDbCommand текстом запроса.

OleDbCommand(String, OleDbConnection)

Инициализирует новый экземпляр класса OleDbCommand с использованием текста запроса и подключения OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Инициализирует новый экземпляр класса OleDbCommand с использованием текста запроса, OleDbConnection и Transaction.

Свойства

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.

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

Возвращает или задает оператор SQL или хранимую процедуру, выполняемую над источником данных.

CommandTimeout

Возвращает или задает время ожидания (в секундах) перед прекращением попытки выполнить команду и выводом ошибки.

CommandType

Возвращает или задает значение, которое указывает, как интерпретируется свойство CommandText.

Connection

Возвращает или задает объект OleDbConnection, используемый этим экземпляром класса OleDbCommand.

Container

Возвращает объект IContainer, который содержит коллекцию Component.

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

Возвращает или задает соединение DbConnection, используемое этой командой DbCommand.

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

Возвращает коллекцию объектов DbParameter.

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

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

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

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.

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

Возвращает или задает значение, указывающее, должен ли объект команды отображаться в настраиваемом элементе управления конструктора Windows Forms.

Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.

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

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

Site

Получает или задает ISite объекта Component.

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

Возвращает или задает транзакцию OleDbTransaction, в которой выполняется команда OleDbCommand.

UpdatedRowSource

Возвращает или задает способы применения результатов команд к объекту DataRow при использовании метода Update объекта OleDbDataAdapter.

Методы

Cancel()

Пытается отменить выполнение OleDbCommand.

Clone()

Создает новый объект OleDbCommand, который является копией текущего экземпляра.

CreateDbParameter()

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

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

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

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

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

Dispose()

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

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

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

(Унаследовано от Component)
Dispose(Boolean)

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

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

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

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

Отправляет свойство CommandText свойству Connection и создает объект OleDbDataReader.

ExecuteReader(CommandBehavior)

Отправляет CommandText в Connection и создает OleDbDataReader, используя одно из значений 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()

Выполняет запрос и возвращает первый столбец первой строки в результирующий набор, возвращенный запросом. Такие же дополнительные столбцы также определены.

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()

Возвращает строку, представляющую текущий объект.

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

Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять.

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

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose().

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

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

ICloneable.Clone()

Описание этого члена см. в разделе Clone().

IDbCommand.Connection

Возвращает или задает объект IDbConnection, используемый этим экземпляром класса IDbCommand.

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

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

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

IDbCommand.CreateParameter()

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

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

Описание этого члена см. в разделе ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

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

IDbCommand.Parameters

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

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

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

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

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

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