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 |
Получает или задает ISite объекта Component. (Унаследовано от Component) |
Transaction |
Возвращает или задает транзакцию OdbcTransaction, в которой выполняется команда OdbcCommand. |
UpdatedRowSource |
Возвращает или задает значение, указывающее, каким образом метод 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(), будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта |
ExecuteReader() |
Отправляет свойство CommandText свойству Connection и создает объект OdbcDataReader. |
ExecuteReader(CommandBehavior) |
Отправляет CommandText в Connection и создает OdbcDataReader, используя одно из значений |
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, будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта |
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) |
Настраивает способ выполнения ожиданий для задач, возвращаемых из асинхронного высвобождаемого объекта. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по