ObjectContext.ExecuteStoreQuery ObjectContext.ExecuteStoreQuery ObjectContext.ExecuteStoreQuery ObjectContext.ExecuteStoreQuery Method

Definición

Sobrecargas

ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[])

Ejecuta una consulta directamente con el origen de datos que devuelve una secuencia de resultados con tipo.Executes a query directly against the data source that returns a sequence of typed results.

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

Ejecuta una consulta directamente con el origen de datos y devuelve una secuencia de resultados con tipo.Executes a query directly against the data source and returns a sequence of typed results. Especifique el conjunto de entidades y la opción de combinación para que se pueda realizar el seguimiento de los resultados de la consulta como entidades.Specify the entity set and the merge option so that query results can be tracked as entities.

ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[])

Ejecuta una consulta directamente con el origen de datos que devuelve una secuencia de resultados con tipo.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

Tipo de los datos devueltos.The type of the returned data.

Parámetros

commandText
String String String String

Comando que se va a ejecutar, en el lenguaje nativo del origen de datos.The command to execute, in the native language of the data source.

parameters
Object[]

Matriz de parámetros que se van a pasar al comando.An array of parameters to pass to the command.

Devoluciones

ObjectResult<TElement>

Enumeración de objetos de tipo TElement.An enumeration of objects of type TElement.

Comentarios

El ExecuteStoreQuery método utiliza la conexión existente para ejecutar un comando arbitrario directamente en el origen de datos.The ExecuteStoreQuery method uses the existing connection to execute an arbitrary command directly against the data source. El comando de almacenamiento se ejecuta en el contexto de la transacción actual, si esa transacción existe.The store command is executed in the context of the current transaction, if such a transaction exists.

Llamar al método ExecuteStoreQuery es equivalente a llamar al método ExecuteReader de la clase DbCommand, solamente ExecuteStoreQuery devuelve entidades, y el ExecuteReader devuelve valores de propiedad en el 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.

Llame a ExecuteStoreQuery con el nombre de conjunto de entidades especificado, si desea que se realice el seguimiento de los resultados.Call the ExecuteStoreQuery with the specified entity set name, if you want for the results to be tracked.

DbDataReader Llame al Translate método para convertir un en objetos entidad cuando el lector contiene filas de datos que se asignan al tipo de entidad 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.

La utilización de comandos con parámetros ayuda en la protección contra ataques por inyección de código SQL, en los que un atacante "inyecta" un comando en una instrucción SQL que pone en peligro la seguridad del 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. Los comandos con parámetros se protegen frente a ataques por inyección de código SQL, ya que garantizan que los valores recibidos desde un origen externo se pasan solo como valores y no como parte de la instrucción 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, los comandos SQL insertados en un valor no se ejecutan en el origen de datos.As a result, SQL commands inserted into a value are not executed at the data source. En cambio, se evalúan únicamente como un valor de parámetro.Rather, they are evaluated only as a parameter value. Además de las ventajas de seguridad, los comandos con parámetros proporcionan un método práctico para organizar los valores que se pasan con una instrucción SQL o a un procedimiento almacenado.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.

El valor parameters puede ser una matriz de objetos DbParameter o una matriz de valores de parámetro.The parameters value can be an array of DbParameter objects or an array of parameter values. Si solo se proporcionan valores, se crea una DbParameter matriz de objetos según el orden de los valores de la matriz.If only values are supplied, an array of DbParameter objects are created based on the order of the values in the array.

Para obtener más información, consulte:For more information, see:

Ejecutar directamente comandos de almacenamiento yDirectly Executing Store Commands and

Cómo: Ejecutar comandos directamente en el origen de datosHow to: Directly Execute Commands Against the Data Source

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

Ejecuta una consulta directamente con el origen de datos y devuelve una secuencia de resultados con tipo.Executes a query directly against the data source and returns a sequence of typed results. Especifique el conjunto de entidades y la opción de combinación para que se pueda realizar el seguimiento de los resultados de la consulta 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

Tipo de entidad de los datos devueltos.The entity type of the returned data.

Parámetros

commandText
String String String String

Comando que se va a ejecutar, en el lenguaje nativo del origen de datos.The command to execute, in the native language of the data source.

entitySetName
String String String String

Conjunto de entidades del tipo TEntity.The entity set of the TEntity type. Si no se proporciona un nombre del conjunto de entidades, no se va a hacer un seguimiento de los resultados.If an entity set name is not provided, the results are not going to be tracked.

mergeOption
MergeOption MergeOption MergeOption MergeOption

MergeOption que se va a utilizar al ejecutar la consulta.The MergeOption to use when executing the query. De manera predeterminada, es AppendOnly.The default is AppendOnly.

parameters
Object[]

Matriz de parámetros que se van a pasar al comando.An array of parameters to pass to the command.

Devoluciones

ObjectResult<TEntity>

Enumeración de objetos de tipo TResult.An enumeration of objects of type TResult.

Comentarios

El ExecuteStoreQuery método utiliza la conexión existente para ejecutar un comando arbitrario directamente en el origen de datos.The ExecuteStoreQuery method uses the existing connection to execute an arbitrary command directly against the data source. El comando de almacenamiento se ejecuta en el contexto de la transacción actual, si esa transacción existe.The store command is executed in the context of the current transaction, if such a transaction exists.

Llamar al método ExecuteStoreQuery es equivalente a llamar al método ExecuteReader de la clase DbCommand, solamente ExecuteStoreQuery devuelve entidades, y el ExecuteReader devuelve valores de propiedad en el 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 el nombre del conjunto de entidades, si desea que se realice el seguimiento de los resultados como entidades.Specify the entity set name, if you want for the results to be tracked as entities.

Llame Translate al método para convertir DbDataReader un objeto en objetos entidad cuando el lector contiene filas de datos que se asignan al tipo de entidad especificado.Call Translate method to translate a DbDataReader into entity objects when the reader contains data rows that map to the specified entity type.

La utilización de comandos con parámetros ayuda en la protección contra ataques por inyección de código SQL, en los que un atacante "inyecta" un comando en una instrucción SQL que pone en peligro la seguridad del 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. Los comandos con parámetros se protegen frente a ataques por inyección de código SQL, ya que garantizan que los valores recibidos desde un origen externo se pasan solo como valores y no como parte de la instrucción 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, los comandos SQL insertados en un valor no se ejecutan en el origen de datos.As a result, SQL commands inserted into a value are not executed at the data source. En cambio, se evalúan únicamente como un valor de parámetro.Rather, they are evaluated only as a parameter value. Además de las ventajas de seguridad, los comandos con parámetros proporcionan un método práctico para organizar los valores que se pasan con una instrucción SQL o a un procedimiento almacenado.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.

El valor parameters puede ser una matriz de objetos DbParameter o una matriz de valores de parámetro.The parameters value can be an array of DbParameter objects or an array of parameter values. Si solo se proporcionan valores, se crea una DbParameter matriz de objetos según el orden de los valores de la matriz.If only values are supplied, an array of DbParameter objects are created based on the order of the values in the array.

Para obtener más información, consulte:For more information, see:

Ejecutar directamente comandos de almacenamiento yDirectly Executing Store Commands and

Cómo: Ejecutar comandos directamente en el origen de datosHow to: Directly Execute Commands Against the Data Source

Se aplica a