OleDbCommand Класс

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v11.0.0-preview.2.26159.112

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

OleDbCommand.cs

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

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

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

Object

DbCommand

OleDbCommand

Атрибуты

RequiresDynamicCodeAttribute

Реализации

IDbCommand ICloneable IDisposable

Примеры

В следующем примере для выбора строк из базы данных Access используется OleDbCommand, а также OleDbDataAdapterOleDbConnectionдля выбора строк. Затем возвращается заполнение 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, OleDbConnection, OleDbTransaction)	Инициализирует новый экземпляр OleDbCommand класса с текстом запроса, а OleDbConnectionтакже .Transaction
OleDbCommand(String, OleDbConnection)	Инициализирует новый экземпляр OleDbCommand класса с текстом запроса и .OleDbConnection
OleDbCommand(String)	Инициализирует новый экземпляр OleDbCommand класса с текстом запроса.

Свойства

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

Методы

Имя	Описание
Cancel()	Пытается отменить выполнение объекта OleDbCommand.
Clone()	Создает новый OleDbCommand объект, который является копией текущего экземпляра.
CreateParameter()	Создает новый экземпляр OleDbParameter объекта.
ExecuteNonQuery()	Выполняет инструкцию SQL и Connection возвращает количество затронутых строк.
ExecuteReader()	Отправляет объект CommandText в Connection и создает объект OleDbDataReader.
ExecuteReader(CommandBehavior)	Отправляет объект в CommandText и Connectionсоздает OleDbDataReader одно из CommandBehavior значений.
ExecuteScalar()	Выполняет запрос и возвращает первый столбец первой строки в результирующем наборе, возвращаемом запросом. Дополнительные столбцы или строки игнорируются.
Prepare()	Создает подготовленную (или скомпилированную) версию команды в источнике данных.
ResetCommandTimeout()	Сбрасывает CommandTimeout свойство в значение по умолчанию.

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

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

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

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