OdbcCommand Класс

Определение

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

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

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

Пакет:: System.Data.Odbc v11.0.0-preview.2.26159.112

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

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

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

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

Важно!

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

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

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

DbCommand
OdbcCommand

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

MarshalByRefObject

Component

DbCommand
OdbcCommand

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

MarshalByRefObject

Component
OdbcCommand

Реализации: 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

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

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

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

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

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

Свойства

Имя	Описание
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	Возвращает или задает ISite объект Component. (Унаследовано от Component)
Transaction	Возвращает или задает объект OdbcTransaction , OdbcCommand в пределах которого выполняется.
UpdatedRowSource	Возвращает или задает значение, указывающее, как метод Update должен применять результаты команд к DataRow.

Методы

Имя	Описание
Cancel()	Пытается отменить выполнение объекта OdbcCommand.
CreateDbParameter()	Создает новый экземпляр DbParameter объекта. (Унаследовано от DbCommand)
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateParameter()	Создает новый экземпляр OdbcParameter объекта.
Dispose()	Освобождает все ресурсы, используемые параметром Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые Component и при необходимости освобождает управляемые ресурсы. (Унаследовано от Component)
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, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Вызывается. (Унаследовано от DbCommand)
ExecuteReaderAsync(CommandBehavior)	Асинхронная версия ExecuteReader, которая выполняет команду с его подключением, возвращая DbDataReader объект, который можно использовать для доступа к результатам. 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()	Создает подготовленную или скомпилированную версию команды в источнике данных.
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)

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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