Compartir a través de


ObjectContext.ExecuteStoreQuery Método

Definición

Sobrecargas

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

Ejecuta una consulta directamente en el origen de datos que devuelve una secuencia de resultados con tipo.

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

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

ExecuteStoreQuery<TElement>(String, Object[])

Ejecuta una consulta directamente en el origen de datos que devuelve una secuencia de resultados con tipo.

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.

Parámetros

commandText
String

Comando que se va a ejecutar, en el idioma nativo del origen de datos.

parameters
Object[]

Matriz de parámetros que se van a pasar al comando.

Devoluciones

ObjectResult<TElement>

Enumeración de objetos de tipo TElement.

Comentarios

El ExecuteStoreQuery método usa la conexión existente para ejecutar un comando arbitrario directamente en el origen de datos. El comando store se ejecuta en el contexto de la transacción actual, si existe dicha transacción.

Llamar al ExecuteStoreQuery método es equivalente a llamar al ExecuteReader método de la DbCommand clase , solo ExecuteStoreQuery devuelve entidades y devuelve los ExecuteReader valores de propiedad en .DbDataReader

ExecuteStoreQuery Llame al objeto con el nombre del conjunto de entidades especificado, si desea que se realice el seguimiento de los resultados.

Llame al Translate método para traducir un objeto DbDataReader en objetos de entidad cuando el lector contiene filas de datos que se asignan al tipo de entidad especificado.

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. Los comandos con parámetros protegen contra un ataque por inyección de código SQL garantizando que los valores recibidos de un origen externo se pasan como valores únicamente y no forman parte de la instrucción SQL. Como resultado, los comandos SQL insertados en un valor no se ejecutan en el origen de datos. En su lugar, solo se evalúan como un valor de parámetro. Además de las ventajas de seguridad, los comandos con parámetros proporcionan un método práctico para organizar los valores pasados con una instrucción SQL o a un procedimiento almacenado.

El parameters valor puede ser una matriz de DbParameter objetos o una matriz de valores de parámetro. Si solo se proporcionan valores, se crea una matriz de DbParameter objetos en función del orden de los valores de la matriz.

Se aplica a

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

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

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>
Public Function ExecuteStoreQuery(Of TEntity) (commandText As String, entitySetName As String, mergeOption As MergeOption, ParamArray parameters As Object()) As ObjectResult(Of TEntity)

Parámetros de tipo

TEntity

Tipo de entidad de los datos devueltos.

Parámetros

commandText
String

Comando que se va a ejecutar, en el idioma nativo del origen de datos.

entitySetName
String

Conjunto de entidades del TEntity tipo. Si no se proporciona un nombre de conjunto de entidades, no se realizará el seguimiento de los resultados.

mergeOption
MergeOption

que MergeOption se va a usar al ejecutar la consulta. El valor predeterminado es AppendOnly.

parameters
Object[]

Matriz de parámetros que se van a pasar al comando.

Devoluciones

ObjectResult<TEntity>

Enumeración de objetos de tipo TResult.

Comentarios

El ExecuteStoreQuery método usa la conexión existente para ejecutar un comando arbitrario directamente en el origen de datos. El comando store se ejecuta en el contexto de la transacción actual, si existe dicha transacción.

Llamar al ExecuteStoreQuery método es equivalente a llamar al ExecuteReader método de la DbCommand clase , solo ExecuteStoreQuery devuelve entidades y devuelve los ExecuteReader valores de propiedad en .DbDataReader

Especifique el nombre del conjunto de entidades, si desea que se realice el seguimiento de los resultados como entidades.

Llame Translate al método para traducir a objetos DbDataReader de entidad cuando el lector contiene filas de datos que se asignan al tipo de entidad especificado.

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. Los comandos con parámetros protegen contra un ataque por inyección de código SQL garantizando que los valores recibidos de un origen externo se pasan como valores únicamente y no forman parte de la instrucción SQL. Como resultado, los comandos SQL insertados en un valor no se ejecutan en el origen de datos. En su lugar, solo se evalúan como un valor de parámetro. Además de las ventajas de seguridad, los comandos con parámetros proporcionan un método práctico para organizar los valores pasados con una instrucción SQL o a un procedimiento almacenado.

El parameters valor puede ser una matriz de DbParameter objetos o una matriz de valores de parámetro. Si solo se proporcionan valores, se crea una matriz de DbParameter objetos en función del orden de los valores de la matriz.

Se aplica a