SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte data z podkladové databáze pomocí SelectCommand řetězce SQL a všech parametrů, které jsou v kolekci SelectParameters .
protected public:
override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParametry
- arguments
- DataSourceSelectArguments
Objekt DataSourceSelectArguments používaný k vyžádání operací s daty nad rámec základního načtení dat.
Návraty
Seznam IEnumerable řádků dat.
Výjimky
Metoda arguments předaná ExecuteSelect(DataSourceSelectArguments) metodě určuje, že zdroj dat by měl při načítání dat provést další práci, aby bylo možné stránkovat nebo řadit načtená data, ale ovládací prvek zdroje dat nepodporuje požadovanou schopnost.
-nebo-
Ukládání do mezipaměti je povolené, DataSourceMode ale vlastnost zdroje dat není nastavená na DataSethodnotu .
-nebo-
Vlastnost je nastavená SortParameterName , ale CommandType není nastavená na StoredProcedurehodnotu .
Zdroj dat nemůže vytvořit připojení k databázi.
-nebo-
Ukládání do mezipaměti je povolené, ale interní mezipaměť a typy příkazů se neshodují.
Poznámky
Třída SqlDataSourceView implementuje zděděnou ExecuteSelect metodu pro načtení dat z databáze. Vývojáři stránek a autoři ovládacích prvků vázaných na data nevolají metodu ExecuteSelect přímo, ale používají veřejně vystavenou Select metodu.
Před načtením dat je OnSelecting volána metoda pro vyvolání Selecting události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a provedli jakékoli předběžné zpracování před načtením dat.
K provedení operace SqlDataSourceView objekt sestaví DbCommand objekt pomocí SelectCommand textu a libovolného přidruženého SelectParametersobjektu a provede ho v podkladové databázi. Po dokončení OnSelected operace je volána metoda pro vyvolání Selected události. Tuto událost můžete zpracovat ke kontrole případných návratových hodnot a kódů chyb a následnému zpracování.
Metoda ExecuteSelect vrátí objekt, DataView pokud DataSourceMode je nastaven na DataSethodnotu , nebo IDataReader objekt, pokud DataSourceMode je nastaven na DataReaderhodnotu . IDataReader Po dokončení čtení dat objekt zavřete.
Pokud je hodnota nastavená DataSourceMode na DataSet a ukládání do mezipaměti je povoleno, SqlDataSourceView načítá data z mezipaměti a ukládá je do mezipaměti během operace s daty. Mezipaměť se vytvoří, zahodí nebo aktualizuje na základě chování ukládání do mezipaměti určeného CacheDuration kombinací vlastností a CacheExpirationPolicy .
Důležité
Pokud používáte zosobnění klienta v rámci ověřování systému Windows, data se ukládají do mezipaměti, když k datům přistupuje první uživatel. Pokud o stejná data požádá jiný uživatel, načtou se data z mezipaměti. Data se nenačtou jiným voláním databáze za účelem ověření přístupu uživatele k datům. Pokud očekáváte, že k datům bude přistupovat více uživatelů a chcete, aby každé načtení dat bylo ověřeno konfigurací zabezpečení databáze, nepoužívejte ukládání do mezipaměti.
DataSourceMode Pokud je hodnota nastavená na DataSet a FilterExpression byla zadána, vyhodnotí se společně se všemi zadanými FilterParameters položkami a výsledný filtr se použije na seznam dat během operace načítání dat.
