OdbcCommand Класс

Определение

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

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OdbcCommand = class
    inherit DbCommand
    interface ICloneable
type OdbcCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Наследование
Наследование
Реализации

Примеры

В следующем примере используется ExecuteNonQuery.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Комментарии

Класс OdbcCommand предоставляет следующие методы для выполнения команд в источнике данных:

Пункт Описание
ExecuteReader Выполняет команды, возвращающие строки.
ExecuteNonQuery Выполняет такие команды, как SQL INSERT, DELETE, UPDATE и SET.
ExecuteScalar Извлекает одно значение, например статистическое значение, из базы данных.

Можно сбросить свойство CommandText и повторно использовать объект OdbcCommand. Однако перед выполнением новой или предыдущей команды необходимо закрыть OdbcDataReader.

Если выполнение команды вызывает неустранимая OdbcException, например уровень серьезности SQL Server 20 или более, OdbcConnection может закрыться. Однако пользователь может повторно открыть подключение и продолжить.

Конструкторы

OdbcCommand()

Инициализирует новый экземпляр класса OdbcCommand.

OdbcCommand(String)

Инициализирует новый экземпляр класса OdbcCommand с текстом запроса.

OdbcCommand(String, OdbcConnection)

Инициализирует новый экземпляр класса OdbcCommand с текстом запроса и объектом OdbcConnection.

OdbcCommand(String, OdbcConnection, OdbcTransaction)

Инициализирует новый экземпляр класса OdbcCommand с текстом запроса, объектом OdbcConnection и Transaction.

Свойства

CanRaiseEvents

Возвращает значение, указывающее, может ли компонент вызвать событие.

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

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

CommandTimeout

Возвращает или задает время ожидания (в секундах), прежде чем завершать попытку выполнить команду и создать ошибку.

CommandType

Возвращает или задает значение, указывающее, как интерпретируется свойство CommandText.

Connection

Возвращает или задает OdbcConnection, используемый этим экземпляром OdbcCommand.

Container

Возвращает IContainer, содержащую Component.

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

Возвращает или задает DbConnection, используемый этим DbCommand.

(Унаследовано от DbCommand)
DbParameterCollection

Возвращает коллекцию объектов DbParameter.

(Унаследовано от DbCommand)
DbTransaction

Возвращает или задает DbTransaction, в которой выполняется этот объект DbCommand.

(Унаследовано от DbCommand)
DesignMode

Возвращает значение, указывающее, находится ли Component в режиме конструктора.

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

Возвращает или задает значение, указывающее, должен ли объект команды отображаться в настраиваемом элементе управления интерфейсом.

Events

Возвращает список обработчиков событий, подключенных к этой Component.

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

Возвращает OdbcParameterCollection.

Site

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

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

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

UpdatedRowSource

Возвращает или задает значение, указывающее, как метод update update должен применять результаты команд к DataRow.

Методы

Cancel()

Пытается отменить выполнение OdbcCommand.

CreateDbParameter()

Создает новый экземпляр объекта DbParameter.

(Унаследовано от DbCommand)
CreateObjRef(Type)

Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
CreateParameter()

Создает новый экземпляр объекта OdbcParameter.

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 и создает OdbcDataReader.

ExecuteReader(CommandBehavior)

Отправляет CommandText в Connectionи создает OdbcDataReader с помощью одного из значений 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.

IDbCommand.CreateParameter()

Создает новый экземпляр объекта IDbDataParameter.

(Унаследовано от DbCommand)
IDbCommand.ExecuteReader()

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Выполняет CommandText для Connection и создает IDataReader.

IDbCommand.ExecuteReader()

Выполняет CommandText для Connection и создает IDataReader.

(Унаследовано от DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Выполняет CommandText в Connectionи создает IDataReader с помощью указанного поведения.

IDbCommand.ExecuteReader(CommandBehavior)

Выполняет CommandText в Connectionи создает IDataReader с помощью одного из значений CommandBehavior.

(Унаследовано от DbCommand)
IDbCommand.Parameters

Возвращает IDataParameterCollection.

(Унаследовано от DbCommand)
IDbCommand.Transaction

Возвращает или задает DbTransaction, в которой выполняется этот объект DbCommand.

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

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

ConfigureAwait(IAsyncDisposable, Boolean)

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

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

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