OleDbCommand Класс

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v9.0.0-preview.7.24405.7

Исходный код:

OleDbCommand.cs

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

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

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

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Реализации

IDbCommand ICloneable IDisposable

Примеры

В следующем примере используется 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(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)
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()	Создает новый экземпляр объекта IDbDataParameter. (Унаследовано от DbCommand)
IDbCommand.ExecuteReader()	Описание этого элемента см. в разделе ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Выполняет CommandText в Connectionи создает IDataReader с помощью одного из значений CommandBehavior.
IDbCommand.Parameters	Возвращает IDataParameterCollection. (Унаследовано от DbCommand)
IDbCommand.Transaction	Возвращает или задает DbTransaction, в которой выполняется этот объект DbCommand. (Унаследовано от DbCommand)

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

ConfigureAwait(IAsyncDisposable, Boolean)

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

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

• OleDbDataAdapter
• OleDbConnection
• работа с командами