EntityCommand Classe

Definição

Representa um comando para a camada conceptual.

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
Herança

Construtores

Name Description
EntityCommand()

Inicializa uma nova instância da EntityCommand classe usando os valores especificados.

EntityCommand(String, EntityConnection, EntityTransaction)

Inicializa uma nova instância da EntityCommand classe com a instrução, ligação e transação especificadas.

EntityCommand(String, EntityConnection)

Inicializa uma nova instância da EntityCommand classe com a instrução e ligação especificadas.

EntityCommand(String)

Inicializa uma nova instância da EntityCommand classe com a instrução especificada.

Propriedades

Name Description
CanRaiseEvents

Obtém um valor que indica se o componente pode gerar um evento.

(Herdado de Component)
CommandText

Recebe ou define uma instrução SQL Entity que especifica um comando ou procedimento armazenado a executar.

CommandTimeout

Obtém ou define o tempo de espera antes de expirar.

CommandTree

Obtém ou define a árvore de comandos para executar; apenas um da árvore de comandos ou do texto de comando pode ser definido, não ambos.

CommandType

Obtém ou define um valor que indica como a CommandText propriedade deve ser interpretada.

Connection

Obtém ou define o EntityConnection usado pelo EntityCommand.

Container

Obtém o IContainer que contém o Component.

(Herdado de Component)
DbConnection

Obtém ou define o DbConnection usado por este DbCommand.

(Herdado de DbCommand)
DbParameterCollection

Fica com a coleção de DbParameter objetos.

(Herdado de DbCommand)
DbTransaction

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.

(Herdado de DbCommand)
DesignMode

Obtém um valor que indica se o Component está atualmente em modo de design.

(Herdado de Component)
DesignTimeVisible

Recebe ou define um valor que indica se o objeto de comando deve ser visível num controlo do Windows Form Designer.

EnablePlanCaching

Recebe ou define um valor que indica se a cache do plano de consulta está ativada.

Events

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
Parameters

Obtém os parâmetros da instrução SQL da Entidade ou procedimento armazenado.

Site

Obtém ou define o ISite do Component.

(Herdado de Component)
Transaction

Obtém ou define a transação dentro da qual executa SqlCommand .

UpdatedRowSource

Obtém ou define como os resultados dos comandos são aplicados às linhas a serem atualizadas.

Métodos

Name Description
Cancel()

Cancela a execução de um EntityCommand.

CreateDbParameter()

Cria uma nova instância de um DbParameter objeto.

(Herdado de DbCommand)
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
CreateParameter()

Cria uma nova instância de um EntityParameter objeto.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteDbDataReader(CommandBehavior)

Executa o comando contra a sua ligação, devolvendo um DbDataReader que pode ser usado para aceder aos resultados.

(Herdado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Os fornecedores devem implementar este método para fornecer uma implementação não padrão para ExecuteReader sobrecargas.

A implementação padrão invoca o método síncrono ExecuteReader() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido.

(Herdado de DbCommand)
ExecuteNonQuery()

Executa o comando atual.

ExecuteNonQueryAsync()

Uma versão assíncrona de ExecuteNonQuery(), que executa o comando contra o seu objeto de ligação, devolvendo o número de linhas afetadas.

Invoca ExecuteNonQueryAsync(CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.

A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.

(Herdado de DbCommand)
ExecuteReader()

Executa o comando e devolve um leitor de dados.

ExecuteReader(CommandBehavior)

Compila o CommandText numa árvore de comandos e passa-o para o fornecedor de armazenamento subjacente para execução, depois constrói um EntityDataReader conjunto de resultados produzido usando o especificado CommandBehavior.

ExecuteReaderAsync()

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteReaderAsync(CancellationToken)

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteReaderAsync(CommandBehavior)

Uma versão assíncrona de ExecuteReader, que executa o comando contra a sua ligação, retornando a DbDataReader que pode ser usada para aceder aos resultados.

Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Herdado de DbCommand)
ExecuteScalar()

Executa o comando e retorna a primeira coluna da primeira linha do conjunto de resultados. Colunas ou linhas adicionais são ignoradas.

ExecuteScalarAsync()

Uma versão assíncrona de ExecuteScalar(), que executa o comando e devolve a primeira coluna da primeira linha do primeiro conjunto de resultados devolvido. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.

Invoca ExecuteScalarAsync(CancellationToken) com CancellationToken.None.

(Herdado de DbCommand)
ExecuteScalarAsync(CancellationToken)

Esta é a versão assíncrona de ExecuteScalar(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.

A implementação padrão invoca o método síncrono ExecuteScalar() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteScalar serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.

(Herdado de DbCommand)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetService(Type)

Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
Prepare()

Compila o comando ao nível da entidade e cria uma versão preparada do comando.

ToString()

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)
ToTraceString()

Compila o comando ao nível da entidade e devolve o texto do comando armazenar.

evento

Name Description
Disposed

Ocorre quando o componente é eliminado por uma chamada ao Dispose() método.

(Herdado de Component)

Implementações de Interface Explícita

Name Description
IDbCommand.Connection

Obtém ou define o IDbConnection usado por esta instância do IDbCommand.

(Herdado de DbCommand)
IDbCommand.CreateParameter()

Cria uma nova instância de um IDbDataParameter objeto.

(Herdado de DbCommand)
IDbCommand.ExecuteReader()

Executa o CommandText contra o Connection e constrói um IDataReader.

(Herdado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Executa o CommandText contra o Connection, e constrói um IDataReader usando um dos CommandBehavior valores.

(Herdado de DbCommand)
IDbCommand.Parameters

Obtém o IDataParameterCollection.

(Herdado de DbCommand)
IDbCommand.Transaction

Obtém ou define o DbTransaction dentro do qual este DbCommand objeto executa.

(Herdado de DbCommand)

Aplica-se a