ObjectContext.ExecuteStoreQuery Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Túlterhelések
| Name | Description |
|---|---|
| ExecuteStoreQuery<TElement>(String, Object[]) |
Közvetlenül az adatforrásra irányuló lekérdezést hajt végre, amely gépelt eredmények sorozatát adja vissza. |
| ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[]) |
Közvetlenül az adatforráson végrehajt egy lekérdezést, és gépelt eredményeket ad vissza. Adja meg az entitáskészletet és az egyesítési beállítást, hogy a lekérdezés eredményei entitásként nyomon követhetők legyenek. |
ExecuteStoreQuery<TElement>(String, Object[])
Közvetlenül az adatforrásra irányuló lekérdezést hajt végre, amely gépelt eredmények sorozatát adja vissza.
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)
Típusparaméterek
- TElement
A visszaadott adatok típusa.
Paraméterek
- commandText
- String
A végrehajtandó parancs az adatforrás anyanyelvén.
- parameters
- Object[]
A parancsnak átadni kívánt paraméterek tömbje.
Válaszok
A típusobjektumok TElementszámbavétele.
Megjegyzések
A ExecuteStoreQuery metódus a meglévő kapcsolat használatával hajt végre egy tetszőleges parancsot közvetlenül az adatforráson. Az áruház parancs végrehajtása az aktuális tranzakció kontextusában történik, ha létezik ilyen tranzakció.
A ExecuteStoreQuery metódus meghívása egyenértékű az ExecuteReader osztály metódusának DbCommand meghívásával, csak ExecuteStoreQuery az entitásokat és a ExecuteReader visszaadott tulajdonságértékeket adja vissza a DbDataReader.
Hívja meg a ExecuteStoreQuery megadott entitáskészlet nevét, ha nyomon szeretné követni az eredményeket.
A metódus meghívása Translate entitásobjektumokká való fordítására DbDataReader , ha az olvasó olyan adatsorokat tartalmaz, amelyek megfeleltetik a megadott entitástípust.
A paraméteres parancsok segítenek védekezni az SQL-injektálási támadások ellen, amelyekben a támadó "injektál" egy parancsot egy SQL-utasításba, amely veszélyezteti a kiszolgáló biztonságát. A paraméteres parancsok védik az SQL-injektálási támadásokat azáltal, hogy garantálják, hogy a külső forrásból kapott értékek csak értékekként lesznek átadva, és nem részei az SQL-utasításnak. Ennek eredményeképpen az értékbe beszúrt SQL-parancsok nem lesznek végrehajtva az adatforrásban. A rendszer inkább csak paraméterértékként értékeli ki őket. A biztonsági előnyök mellett a paraméteres parancsok kényelmes módszert biztosítanak az SQL-utasítással vagy egy tárolt eljárással átadott értékek rendszerezésére.
Az parameters érték lehet objektumtömb DbParameter vagy paraméterértékek tömbje. Ha csak értékeket ad meg, az objektumtömb DbParameter a tömb értékeinek sorrendje alapján jön létre.
További információkért lásd:
Áruházi parancsok közvetlen végrehajtása és
Útmutató: Parancsok közvetlen végrehajtása az adatforráson
A következőre érvényes:
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])
Közvetlenül az adatforráson végrehajt egy lekérdezést, és gépelt eredményeket ad vissza. Adja meg az entitáskészletet és az egyesítési beállítást, hogy a lekérdezés eredményei entitásként nyomon követhetők legyenek.
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)
Típusparaméterek
- TEntity
A visszaadott adatok entitástípusa.
Paraméterek
- commandText
- String
A végrehajtandó parancs az adatforrás anyanyelvén.
- entitySetName
- String
A típus entitáskészlete TEntity . Ha nincs megadva egy entitáskészlet neve, az eredmények nem lesznek nyomon követve.
- mergeOption
- MergeOption
A MergeOption lekérdezés végrehajtásakor használni kívánt elem. Az alapértelmezett érték a AppendOnly.
- parameters
- Object[]
A parancsnak átadni kívánt paraméterek tömbje.
Válaszok
A típusobjektumok TResultszámbavétele.
Megjegyzések
A ExecuteStoreQuery metódus a meglévő kapcsolat használatával hajt végre egy tetszőleges parancsot közvetlenül az adatforráson. Az áruház parancs végrehajtása az aktuális tranzakció kontextusában történik, ha létezik ilyen tranzakció.
A ExecuteStoreQuery metódus meghívása egyenértékű az ExecuteReader osztály metódusának DbCommand meghívásával, csak ExecuteStoreQuery az entitásokat és a ExecuteReader visszaadott tulajdonságértékeket adja vissza a DbDataReader.
Adja meg az entitáskészlet nevét, ha azt szeretné, hogy az eredmények entitásként legyenek nyomon követve.
Metódus meghívása Translate entitásobjektumokká való fordításához DbDataReader , ha az olvasó olyan adatsorokat tartalmaz, amelyek megfeleltetik a megadott entitástípust.
A paraméteres parancsok segítenek védekezni az SQL-injektálási támadások ellen, amelyekben a támadó "injektál" egy parancsot egy SQL-utasításba, amely veszélyezteti a kiszolgáló biztonságát. A paraméteres parancsok védik az SQL-injektálási támadásokat azáltal, hogy garantálják, hogy a külső forrásból kapott értékek csak értékekként lesznek átadva, és nem részei az SQL-utasításnak. Ennek eredményeképpen az értékbe beszúrt SQL-parancsok nem lesznek végrehajtva az adatforrásban. A rendszer inkább csak paraméterértékként értékeli ki őket. A biztonsági előnyök mellett a paraméteres parancsok kényelmes módszert biztosítanak az SQL-utasítással vagy egy tárolt eljárással átadott értékek rendszerezésére.
Az parameters érték lehet objektumtömb DbParameter vagy paraméterértékek tömbje. Ha csak értékeket ad meg, az objektumtömb DbParameter a tömb értékeinek sorrendje alapján jön létre.
További információkért lásd:
Áruházi parancsok közvetlen végrehajtása és
Útmutató: Parancsok közvetlen végrehajtása az adatforráson