OdbcCommand Класс

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

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

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

OdbcCommand.cs

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

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

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

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Реализации

ICloneable

Примеры

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

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

ConfigureAwait(IAsyncDisposable, Boolean)

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

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

• OdbcDataAdapter
• OdbcConnection
• выполнение команды