ObjectContext.ExecuteStoreQuery Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| ExecuteStoreQuery<TElement>(String, Object[]) |
Выполняет запрос непосредственно к источнику данных, который возвращает последовательность типизированных результатов. |
| ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[]) |
Выполняет запрос непосредственно к источнику данных и возвращает последовательность типизированных результатов. Укажите набор сущностей и параметр слияния, чтобы результаты запроса могли отслеживаться как сущности. |
ExecuteStoreQuery<TElement>(String, Object[])
Выполняет запрос непосредственно к источнику данных, который возвращает последовательность типизированных результатов.
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)Параметры типа
- TElement
Тип возвращаемых данных.
Параметры
- commandText
- String
Команда, выполняемая на собственном языке источника данных.
- parameters
- Object[]
Массив параметров, передаваемых команде.
Возвращаемое значение
Перечисление объектов типа TElement.
Комментарии
Метод ExecuteStoreQuery использует существующее подключение для выполнения произвольной команды непосредственно в источнике данных. Команда хранилища выполняется в контексте текущей транзакции, если такая транзакция существует.
ExecuteStoreQuery Вызов метода эквивалентен вызову ExecuteReader метода DbCommand класса, возвращает только ExecuteStoreQuery сущности и ExecuteReader возвращаемые значения свойств в объектеDbDataReader.
Вызовите указанное ExecuteStoreQuery имя набора сущностей, если требуется отслеживать результаты.
Translate Вызовите метод для преобразования DbDataReader объекта в объекты сущностей, когда читатель содержит строки данных, которые сопоставляют с указанным типом сущности.
Использование параметризованных команд помогает защищаться от атак путем внедрения кода SQL, в которых атакующий «внедряет» в инструкцию SQL команду, нарушающую безопасность сервера. Параметризованные команды обеспечивают защиту от атаки внедрения SQL, гарантируя, что значения, полученные из внешнего источника, передаются только в качестве значений, а не часть инструкции SQL. В результате команды SQL, вставляемые в значение, не выполняются в источнике данных. Скорее, они оцениваются только как значение параметра. Помимо преимуществ безопасности параметризованные команды предоставляют удобный метод для организации значений, передаваемых с помощью инструкции SQL или хранимой процедуры.
Это parameters значение может быть массивом DbParameter объектов или массивом значений параметров. Если предоставляются только значения, массив DbParameter объектов создается на основе порядка значений в массиве.
Применяется к
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])
Выполняет запрос непосредственно к источнику данных и возвращает последовательность типизированных результатов. Укажите набор сущностей и параметр слияния, чтобы результаты запроса могли отслеживаться как сущности.
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)Параметры типа
- TEntity
Тип сущности возвращаемых данных.
Параметры
- commandText
- String
Команда, выполняемая на собственном языке источника данных.
- entitySetName
- String
Набор сущностей TEntity типа. Если имя набора сущностей не указано, результаты не будут отслеживаться.
- mergeOption
- MergeOption
Используется MergeOption при выполнении запроса. Значение по умолчанию — AppendOnly.
- parameters
- Object[]
Массив параметров, передаваемых команде.
Возвращаемое значение
Перечисление объектов типа TResult.
Комментарии
Метод ExecuteStoreQuery использует существующее подключение для выполнения произвольной команды непосредственно в источнике данных. Команда хранилища выполняется в контексте текущей транзакции, если такая транзакция существует.
ExecuteStoreQuery Вызов метода эквивалентен вызову ExecuteReader метода DbCommand класса, возвращает только ExecuteStoreQuery сущности и ExecuteReader возвращаемые значения свойств в объектеDbDataReader.
Укажите имя набора сущностей, если требуется отслеживать результаты как сущности.
Метод вызова Translate для преобразования DbDataReader объекта в объекты сущностей, когда средство чтения содержит строки данных, сопоставленные с указанным типом сущности.
Использование параметризованных команд помогает защищаться от атак путем внедрения кода SQL, в которых атакующий «внедряет» в инструкцию SQL команду, нарушающую безопасность сервера. Параметризованные команды обеспечивают защиту от атаки внедрения SQL, гарантируя, что значения, полученные из внешнего источника, передаются только в качестве значений, а не часть инструкции SQL. В результате команды SQL, вставляемые в значение, не выполняются в источнике данных. Скорее, они оцениваются только как значение параметра. Помимо преимуществ безопасности параметризованные команды предоставляют удобный метод для организации значений, передаваемых с помощью инструкции SQL или хранимой процедуры.
Это parameters значение может быть массивом DbParameter объектов или массивом значений параметров. Если предоставляются только значения, массив DbParameter объектов создается на основе порядка значений в массиве.
