OleDbCommand Класс

Ссылка

Определение

Пространство имен:: System.Data.OleDb

Сборка:: System.Data.OleDb.dll

Сборка:: System.Data.dll

Пакет:: System.Data.OleDb v8.0.0

Пакет:: System.Data.OleDb v9.0.0-rc.1.24431.7

Исходный код:: OleDbCommand.cs

Исходный код:: OleDbCommand.cs

Исходный код:: OleDbCommand.cs

Исходный код:: OleDbCommand.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет инструкцию 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

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

MarshalByRefObject

Component

DbCommand
OleDbCommand

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

MarshalByRefObject

Component
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

Пункт	Описание
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()	Возвращает 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)

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

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

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