DbCommand DbCommand DbCommand DbCommand Class

Определение

Представляет оператор SQL или хранимую процедуру, применяемую к источнику данных.Represents an SQL statement or stored procedure to execute against a data source. Предоставляет базовый класс для классов, зависящих от базы данных, представляющих команды.Provides a base class for database-specific classes that represent commands. ExecuteNonQueryAsync

public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Наследование
Производный
Реализации

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

DbCommand() DbCommand() DbCommand() DbCommand()

Создает экземпляр объекта DbCommand.Constructs an instance of the DbCommand object.

Свойства

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CommandText CommandText CommandText CommandText

При переопределении в производном классе получает или задает текстовую команду для выполнения в отношении источника данных.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

При переопределении в производном классе получает или задает время ожидания перед завершением попытки выполнить команду и выдачей сообщения об ошибке.When overridden in a derived class, gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

При переопределении в производном классе возвращает или задает способ интерпретации свойства CommandText.When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection Connection Connection Connection

Возвращает или задает объект DbConnection, используемый этим объектом DbCommand.Gets or sets the DbConnection used by this DbCommand.

Container Container Container Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DbConnection DbConnection DbConnection DbConnection

При переопределении в производном классе получает или задает DbConnection, используемый DbCommand.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

DbParameterCollection DbParameterCollection DbParameterCollection DbParameterCollection

При переопределении в производном классе возвращает коллекцию объектов DbParameter.When overridden in a derived class, gets the collection of DbParameter objects.

DbTransaction DbTransaction DbTransaction DbTransaction

При переопределении в производном классе получает или задает DbTransaction, который выполняет этот объект DbCommand.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

При переопределении в производном классе получает или задает значение, определяющее, должен ли объект команды выводиться на экран в настраиваемом элементе управления интерфейса.When overridden in a derived class, gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Parameters Parameters Parameters Parameters

Возвращает коллекцию объектов DbParameter.Gets the collection of DbParameter objects. Дополнительные сведения о параметрах см. в разделе Настройка параметров и типов данных параметров.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site Site Site Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction Transaction

Возвращает или задает контекст DbTransaction, в котором выполняется этот объект DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

При переопределении в производном классе получает или задает способ применения результатов команды к объекту DataRow, если он используется методом Update объекта DbDataAdapter.When overridden in a derived class, gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Методы

Cancel() Cancel() Cancel() Cancel()

При переопределении в производном классе пытается отменить выполнение DbCommand.When overridden in a derived class, attempts to cancel the execution of a DbCommand.

CreateDbParameter() CreateDbParameter() CreateDbParameter() CreateDbParameter()

При переопределении в производном классе создает новый экземпляр объекта DbParameter.When overridden in a derived class, creates a new instance of a DbParameter object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

Создает новый экземпляр объекта DbParameter.Creates a new instance of a DbParameter object.

Dispose() Dispose() Dispose() Dispose()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

Асинхронно размещает объект команды.Asynchronously diposes the command object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior)

При переопределении в производном классе выполняет команду для подключения.When overridden in a derived class, executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Поставщики должны реализовать этот метод, чтобы предоставить реализацию, отличную от реализации по умолчанию, для перегрузок ExecuteReader.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Реализация по умолчанию вызывает синхронный метод ExecuteReader() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Исключения, создаваемые ExecuteReader, будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Этот метод принимает токен отмены, который может использоваться для запроса ранней отмены операции.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Реализации могут игнорировать данный запрос.Implementations may ignore this request.

ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

При переопределении в производном классе выполняет инструкцию SQL для объекта подключения.When overridden in a derived class, executes a SQL statement against a connection object.

ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync()

Асинхронная версия ExecuteNonQuery(), которая выполняет инструкцию SQL относительно объекта соединения.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Вызывает ExecuteNonQueryAsync(CancellationToken) с CancellationToken.None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken)

Это асинхронная версия метода ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать токен отмены.The cancellation token may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод ExecuteNonQuery() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Исключения, создаваемые ExecuteNonQuery(), будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Не вызывайте другие методы и свойства объекта DbCommand до тех пор, пока возвращаемая задача не будет завершена.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Выполняет свойство CommandText применительно к свойству Connection и возвращает объект DbDataReader.Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Выполняет свойство CommandText применительно к свойству Connection и возвращает объект DbDataReader, используя одно из значений типа CommandBehavior.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

Асинхронная версия ExecuteReader, которая выполняет CommandText относительно Connection и возвращает DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) с CancellationToken.None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

Асинхронная версия ExecuteReader, которая выполняет CommandText относительно Connection и возвращает DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Этот метод распространяет уведомление о том, что операции следует отменить.This method propagates a notification that operations should be canceled.

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

Асинхронная версия ExecuteReader, которая выполняет CommandText относительно Connection и возвращает DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

Вызывает ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

При переопределении в производном классе выполняет запрос и возвращает первый столбец первой строки в результирующем наборе, возвращаемом запросом.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. Все другие столбцы и строки игнорируются.All other columns and rows are ignored.

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

Асинхронная версия метода ExecuteScalar(), который выполняет запрос и возвращает первый столбец первой строки в наборе результатов, возвращаемых запросом.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Все другие столбцы и строки игнорируются.All other columns and rows are ignored.

Вызывает ExecuteScalarAsync(CancellationToken) с CancellationToken.None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

Это асинхронная версия метода ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать токен отмены.The cancellation token may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод ExecuteScalar() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Исключения, создаваемые ExecuteScalar, будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Не вызывайте другие методы и свойства объекта DbCommand до тех пор, пока возвращаемая задача не будет завершена.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() Prepare()

При переопределении в производном классе создает подготовленную (или скомпилированную) версию команды в источнике данных.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken)

Асинхронно создает подготовленную (или скомпилированную) версию команды в источнике данных.Asynchronously creates a prepared (or compiled) version of the command on the data source.

ToString() ToString() ToString() ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Inherited from Component)

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

IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection

Возвращает или задает объект IDbConnection, используемый этим экземпляром класса IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

Создает новый экземпляр объекта IDbDataParameter.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

Выполняет CommandText в Connection и создает IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Выполняет CommandText в Connection и строит IDataReader с помощью одного из значений CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters

Возвращает набор IDataParameterCollection.Gets the IDataParameterCollection.

IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction

Возвращает или задает контекст DbTransaction, в котором выполняется этот объект DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

События

Disposed Disposed Disposed Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

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

Дополнительно