OleDbCommand Класс

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

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

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

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.

Свойства

CommandText	Возвращает или задает оператор SQL или хранимую процедуру, выполняемую над источником данных.
CommandTimeout	Возвращает или задает время ожидания (в секундах) перед прекращением попытки выполнить команду и выводом ошибки.
CommandType	Возвращает или задает значение, которое указывает, как интерпретируется свойство CommandText.
Connection	Возвращает или задает объект OleDbConnection, используемый этим экземпляром класса OleDbCommand.
DbConnection	Возвращает или задает соединение DbConnection, используемое этой командой DbCommand. (Унаследовано от DbCommand)
DbParameterCollection	Возвращает коллекцию объектов DbParameter. (Унаследовано от DbCommand)
DbTransaction	Возвращает или задает контекст DbTransaction, в котором выполняется этот объект DbCommand. (Унаследовано от DbCommand)
DesignTimeVisible	Возвращает или задает значение, указывающее, должен ли объект команды отображаться в настраиваемом элементе управления конструктора Windows Forms.
Parameters	Возвращает набор OleDbParameterCollection.
Transaction	Возвращает или задает транзакцию OleDbTransaction, в которой выполняется команда OleDbCommand.
UpdatedRowSource	Возвращает или задает способы применения результатов команд к объекту DataRow при использовании метода Update объекта OleDbDataAdapter.

Методы

Cancel()	Пытается отменить выполнение OleDbCommand.
Clone()	Создает новый объект OleDbCommand, который является копией текущего экземпляра.
CreateDbParameter()	Создает новый экземпляр объекта DbParameter. (Унаследовано от DbCommand)
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)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Prepare()	Создает подготовленную (или скомпилированную) версию команды в источнике данных.
PrepareAsync(CancellationToken)	Асинхронно создает подготовленную (или скомпилированную) версию команды в источнике данных. (Унаследовано от DbCommand)
ResetCommandTimeout()	Сбрасывает значение свойства CommandTimeout и задает ему значение по умолчанию.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

ICloneable.Clone()	Описание этого члена см. в разделе Clone().
IDbCommand.ExecuteReader()	Описание этого члена см. в разделе ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Выполняет CommandText применительно к объекту Connection и создает IDataReader с помощью одного из значений CommandBehavior.

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

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