OdbcCommand Класс

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v8.0.0

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

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

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.

Свойства

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

Методы

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

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

ICloneable.Clone()

Описание этого члена см. в разделе Clone().

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

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