ObjectContext.ExecuteStoreQuery Método

Definição

Sobrecargas

ExecuteStoreQuery<TElement>(String, Object[])

Executa uma consulta diretamente na fonte de dados que retorna uma sequência de resultados digitados.Executes a query directly against the data source that returns a sequence of typed results.

ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])

Executa uma consulta diretamente na fonte de dados e retorna uma sequência de resultados digitados.Executes a query directly against the data source and returns a sequence of typed results. Especifique o conjunto de entidades e a opção de mesclagem para que os resultados da consulta possam ser controlados como entidades.Specify the entity set and the merge option so that query results can be tracked as entities.

ExecuteStoreQuery<TElement>(String, Object[])

Executa uma consulta diretamente na fonte de dados que retorna uma sequência de resultados digitados.Executes a query directly against the data source that returns a sequence of typed results.

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteStoreQuery(System::String ^ commandText, ... cli::array <System::Object ^> ^ parameters);
public System.Data.Objects.ObjectResult<TElement> ExecuteStoreQuery<TElement> (string commandText, params object[] parameters);
member this.ExecuteStoreQuery : string * obj[] -> System.Data.Objects.ObjectResult<'Element>
Public Function ExecuteStoreQuery(Of TElement) (commandText As String, ParamArray parameters As Object()) As ObjectResult(Of TElement)

Parâmetros de tipo

TElement

O tipo dos dados retornados.The type of the returned data.

Parâmetros

commandText
String

O comando a ser executado, na linguagem nativa da fonte de dados.The command to execute, in the native language of the data source.

parameters
Object[]

Uma matriz de parâmetros a serem passados para o comando.An array of parameters to pass to the command.

Retornos

ObjectResult<TElement>

Uma enumeração de objetos do tipo TElement.An enumeration of objects of type TElement.

Comentários

O ExecuteStoreQuery método usa a conexão existente para executar um comando arbitrário diretamente na fonte de dados.The ExecuteStoreQuery method uses the existing connection to execute an arbitrary command directly against the data source. O comando Store é executado no contexto da transação atual, se essa transação existir.The store command is executed in the context of the current transaction, if such a transaction exists.

Chamar o ExecuteStoreQuery método é equivalente a chamar o ExecuteReader método da DbCommand classe, só ExecuteStoreQuery retorna entidades e os ExecuteReader valores de propriedade retornados no DbDataReader.Calling the ExecuteStoreQuery method is equivalent to calling the ExecuteReader method of the DbCommand class, only ExecuteStoreQuery returns entities and the ExecuteReader returns property values in the DbDataReader.

Chame o ExecuteStoreQuery com o nome do conjunto de entidades especificado, se desejar que os resultados sejam acompanhados.Call the ExecuteStoreQuery with the specified entity set name, if you want for the results to be tracked.

Chame o Translate método para converter um DbDataReader em objetos de entidade quando o leitor contiver linhas de dados que são mapeadas para o tipo de entidade especificado.Call the Translate method to translate a DbDataReader into entity objects when the reader contains data rows that map to the specified entity type.

O uso de comandos com parâmetros ajuda a proteger contra ataques de injeção de SQL, em que um invasor "injeta" um comando em uma instrução SQL que compromete a segurança no servidor.Using parameterized commands helps guard against SQL injection attacks, in which an attacker "injects" a command into a SQL statement that compromises security on the server. Os comandos com parâmetros são protegidos contra um ataque de injeção de SQL, garantindo que os valores recebidos de uma fonte externa sejam passados apenas como valores e não façam parte da instrução SQL.Parameterized commands guard against a SQL injection attack by guaranteeing that values received from an external source are passed as values only, and not part of the SQL statement. Como resultado, os comandos SQL inseridos em um valor não são executados na fonte de dados.As a result, SQL commands inserted into a value are not executed at the data source. Em vez disso, eles são avaliados apenas como um valor de parâmetro.Rather, they are evaluated only as a parameter value. Além dos benefícios de segurança, os comandos com parâmetros fornecem um método conveniente para organizar valores passados com uma instrução SQL ou um procedimento armazenado.In addition to the security benefits, parameterized commands provide a convenient method for organizing values passed with a SQL statement or to a stored procedure.

O parameters valor pode ser uma matriz de DbParameter objetos ou uma matriz de valores de parâmetro.The parameters value can be an array of DbParameter objects or an array of parameter values. Se apenas os valores forem fornecidos, uma matriz DbParameter de objetos será criada com base na ordem dos valores na matriz.If only values are supplied, an array of DbParameter objects are created based on the order of the values in the array.

Para obter mais informações, consulte:For more information, see:

Executando diretamente comandos Store eDirectly Executing Store Commands and

Como: Executar comandos diretamente na fonte de dadosHow to: Directly Execute Commands Against the Data Source

ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])

Executa uma consulta diretamente na fonte de dados e retorna uma sequência de resultados digitados.Executes a query directly against the data source and returns a sequence of typed results. Especifique o conjunto de entidades e a opção de mesclagem para que os resultados da consulta possam ser controlados como entidades.Specify the entity set and the merge option so that query results can be tracked as entities.

public:
generic <typename TEntity>
 System::Data::Objects::ObjectResult<TEntity> ^ ExecuteStoreQuery(System::String ^ commandText, System::String ^ entitySetName, System::Data::Objects::MergeOption mergeOption, ... cli::array <System::Object ^> ^ parameters);
public System.Data.Objects.ObjectResult<TEntity> ExecuteStoreQuery<TEntity> (string commandText, string entitySetName, System.Data.Objects.MergeOption mergeOption, params object[] parameters);
member this.ExecuteStoreQuery : string * string * System.Data.Objects.MergeOption * obj[] -> System.Data.Objects.ObjectResult<'Entity>

Parâmetros de tipo

TEntity

O tipo de entidade do dado retornado.The entity type of the returned data.

Parâmetros

commandText
String

O comando a ser executado, na linguagem nativa da fonte de dados.The command to execute, in the native language of the data source.

entitySetName
String

O conjunto de entidades do tipo TEntity.The entity set of the TEntity type. Se um nome de conjunto de entidades não for fornecido, os resultados não serão rastreados.If an entity set name is not provided, the results are not going to be tracked.

mergeOption
MergeOption

O MergeOption para usar ao executar a consulta.The MergeOption to use when executing the query. O padrão é AppendOnly.The default is AppendOnly.

parameters
Object[]

Uma matriz de parâmetros a serem passados para o comando.An array of parameters to pass to the command.

Retornos

ObjectResult<TEntity>

Uma enumeração de objetos do tipo TResult.An enumeration of objects of type TResult.

Comentários

O ExecuteStoreQuery método usa a conexão existente para executar um comando arbitrário diretamente na fonte de dados.The ExecuteStoreQuery method uses the existing connection to execute an arbitrary command directly against the data source. O comando Store é executado no contexto da transação atual, se essa transação existir.The store command is executed in the context of the current transaction, if such a transaction exists.

Chamar o ExecuteStoreQuery método é equivalente a chamar o ExecuteReader método da DbCommand classe, só ExecuteStoreQuery retorna entidades e os ExecuteReader valores de propriedade retornados no DbDataReader.Calling the ExecuteStoreQuery method is equivalent to calling the ExecuteReader method of the DbCommand class, only ExecuteStoreQuery returns entities and the ExecuteReader returns property values in the DbDataReader.

Especifique o nome do conjunto de entidades, se desejar que os resultados sejam acompanhados como entidades.Specify the entity set name, if you want for the results to be tracked as entities.

Chame Translate o método para converter DbDataReader um em objetos de entidade quando o leitor contiver linhas de dados que são mapeadas para o tipo de entidade especificado.Call Translate method to translate a DbDataReader into entity objects when the reader contains data rows that map to the specified entity type.

O uso de comandos com parâmetros ajuda a proteger contra ataques de injeção de SQL, em que um invasor "injeta" um comando em uma instrução SQL que compromete a segurança no servidor.Using parameterized commands helps guard against SQL injection attacks, in which an attacker "injects" a command into a SQL statement that compromises security on the server. Os comandos com parâmetros são protegidos contra um ataque de injeção de SQL, garantindo que os valores recebidos de uma fonte externa sejam passados apenas como valores e não façam parte da instrução SQL.Parameterized commands guard against a SQL injection attack by guaranteeing that values received from an external source are passed as values only, and not part of the SQL statement. Como resultado, os comandos SQL inseridos em um valor não são executados na fonte de dados.As a result, SQL commands inserted into a value are not executed at the data source. Em vez disso, eles são avaliados apenas como um valor de parâmetro.Rather, they are evaluated only as a parameter value. Além dos benefícios de segurança, os comandos com parâmetros fornecem um método conveniente para organizar valores passados com uma instrução SQL ou um procedimento armazenado.In addition to the security benefits, parameterized commands provide a convenient method for organizing values passed with a SQL statement or to a stored procedure.

O parameters valor pode ser uma matriz de DbParameter objetos ou uma matriz de valores de parâmetro.The parameters value can be an array of DbParameter objects or an array of parameter values. Se apenas os valores forem fornecidos, uma matriz DbParameter de objetos será criada com base na ordem dos valores na matriz.If only values are supplied, an array of DbParameter objects are created based on the order of the values in the array.

Para obter mais informações, consulte:For more information, see:

Executando diretamente comandos Store eDirectly Executing Store Commands and

Como: Executar comandos diretamente na fonte de dadosHow to: Directly Execute Commands Against the Data Source

Aplica-se a