EntityCommand EntityCommand EntityCommand EntityCommand Class

Определение

Представляет команду для концептуального уровня.Represents a command for the conceptual layer.

public ref class EntityCommand sealed : System::Data::Common::DbCommand
public sealed class EntityCommand : System.Data.Common.DbCommand
type EntityCommand = class
    inherit DbCommand
Public NotInheritable Class EntityCommand
Inherits DbCommand
Наследование

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

EntityCommand() EntityCommand() EntityCommand() EntityCommand()

Инициализирует новый экземпляр класса EntityCommand, используя указанные значения.Initializes a new instance of the EntityCommand class using the specified values.

EntityCommand(String) EntityCommand(String) EntityCommand(String) EntityCommand(String)

Инициализирует новый экземпляр класса EntityCommand с заданной инструкцией.Initializes a new instance of the EntityCommand class with the specified statement.

EntityCommand(String, EntityConnection) EntityCommand(String, EntityConnection) EntityCommand(String, EntityConnection) EntityCommand(String, EntityConnection)

Инициализирует новый экземпляр класса EntityCommand с указанной инструкцией и подключением.Initializes a new instance of the EntityCommand class with the specified statement and connection.

EntityCommand(String, EntityConnection, EntityTransaction) EntityCommand(String, EntityConnection, EntityTransaction) EntityCommand(String, EntityConnection, EntityTransaction) EntityCommand(String, EntityConnection, EntityTransaction)

Инициализирует новый экземпляр класса EntityCommand с указанной инструкцией, подключением и транзакцией.Initializes a new instance of the EntityCommand class with the specified statement, connection and transaction.

Свойства

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
CommandText CommandText CommandText CommandText

Возвращает или задает инструкцию Entity SQL, которая определяет команду или хранимую процедуру, подлежащую выполнению.Gets or sets an Entity SQL statement that specifies a command or stored procedure to execute.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Возвращает или задает интервал времени, которое должно пройти до истечения времени ожидания.Gets or sets the amount of time to wait before timing out.

CommandTree CommandTree CommandTree CommandTree

Получает или задает дерево команд для выполнения; может быть задано только дерево команд или текст команды, но не то и другое одновременно.Gets or sets the command tree to execute; only one of the command tree or the command text can be set, not both.

CommandType CommandType CommandType CommandType

Возвращает или задает значение, которое указывает, как должно интерпретироваться свойство CommandText.Gets or sets a value that indicates how the CommandText property is to be interpreted.

Connection Connection Connection Connection

Получает или задает объект EntityConnection, используемый этим объектом EntityCommand.Gets or sets the EntityConnection used by the EntityCommand.

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.

(Inherited from DbCommand)
DbParameterCollection DbParameterCollection DbParameterCollection DbParameterCollection

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

(Inherited from DbCommand)
DbTransaction DbTransaction DbTransaction DbTransaction

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

(Inherited from DbCommand)
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

Возвращает или задает значение, которое указывает, должен ли объект команды быть видимым в элементе управления конструктора Windows Form.Gets or sets a value that indicates whether the command object should be visible in a Windows Form Designer control.

EnablePlanCaching EnablePlanCaching EnablePlanCaching EnablePlanCaching

Получает или задает значение, указывающее, включено ли кэширование плана запроса.Gets or sets a value that indicates whether the query plan caching is enabled.

Events Events Events Events

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

(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.

(Inherited from DbCommand)
IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters

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

(Inherited from DbCommand)
IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction

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

(Inherited from DbCommand)
Parameters Parameters Parameters Parameters

Получает параметры инструкции Entity SQL или хранимой процедуры.Gets the parameters of the Entity SQL statement or stored procedure.

Site Site Site Site

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

(Inherited from Component)
Transaction Transaction Transaction Transaction

Получает или задает транзакцию, в которой выполняется SqlCommand.Gets or sets the transaction within which the SqlCommand executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Получает или задает значение, которое показывает, как результаты команды применяются к обновляемым строкам.Gets or sets how command results are applied to rows being updated.

Методы

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

Отменяет выполнение EntityCommand.Cancels the execution of an EntityCommand.

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

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

(Inherited from DbCommand)
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()

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

Dispose() Dispose() Dispose() Dispose() Inherited from DbCommand
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Inherited from DbCommand
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

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

(Inherited from DbCommand)
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.

(Inherited from DbCommand)
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.

(Inherited from DbCommand)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Выполняет текущую команду.Executes the current command.

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.

(Inherited from DbCommand)
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.

(Inherited from DbCommand)
ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Выполняет команду и возвращает модуль чтения данных.Executes the command and returns a data reader.

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

Компилирует CommandText в дерево команд и передает его к базовому поставщику хранилища для выполнения, затем создает EntityDataReader из созданного результирующего набора, используя указанное CommandBehavior.Compiles the CommandText into a command tree and passes it to the underlying store provider for execution, then builds an EntityDataReader out of the produced result set using the specified CommandBehavior.

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.

(Inherited from DbCommand)
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).

(Inherited from DbCommand)
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).

(Inherited from DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

(Inherited from DbCommand)
ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Выполняет команду и возвращает первый столбец первой строки из результирующего набора.Executes the command, and returns the first column of the first row in the result set. Дополнительные столбцы или строки не обрабатываются.Additional columns or 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.

(Inherited from DbCommand)
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.

(Inherited from DbCommand)
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()

Компилирует команду уровня сущностей и создает подготовленную версию команды.Compiles the entity-level command and creates a prepared version of the command.

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

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

(Inherited from DbCommand)
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)
ToTraceString() ToTraceString() ToTraceString() ToTraceString()

Компилирует команду уровня сущности и возвращает текст команды хранилища.Compiles the entity-level command and returns the store command text.

События

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

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

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

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

(Inherited from DbCommand)
IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

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

(Inherited from DbCommand)
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.

(Inherited from DbCommand)

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