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


OleDbCommand Класс

Определение

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

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 ref class OleDbCommand sealed : 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
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
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, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Наследование
Наследование
Реализации

Примеры

В следующем примере используется OleDbCommand, а также OleDbDataAdapter и OleDbConnectionдля выбора строк из базы данных Access. Затем возвращается заполненная 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

Возвращает или задает ISiteComponent.

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

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

UpdatedRowSource

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

Методы

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

Возвращает 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)

Методы расширения

ConfigureAwait(IAsyncDisposable, Boolean)

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

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

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