AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metod

Definition

Hämtar data från den underliggande datalagringen med hjälp av SQL-strängen SelectCommand i egenskapen och eventuella parametrar i SelectParameters samlingen.

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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametrar

arguments
DataSourceSelectArguments

En DataSourceSelectArguments som används för att begära åtgärder på data utöver grundläggande datahämtning.

Returer

En IEnumerable av datarader.

Undantag

Egenskapen DataFile är null eller en tom sträng ("").

Den arguments som skickas till ExecuteSelect(DataSourceSelectArguments) metoden anger att datakällan ska utföra ytterligare arbete vid hämtning av data för att aktivera växling eller sortering genom hämtade data, men datakällans kontroll stöder inte den begärda funktionen.

Kommentarer

Objektet AccessDataSourceView åsidosätter ExecuteSelect metoden för att säkerställa att egenskapen för dess DataFile associerade AccessDataSource kontroll har angetts innan data hämtas.

ExecuteSelect Innan metoden utförs OnSelecting anropas metoden för att generera Selecting händelsen. Du kan hantera Selecting händelsen för att undersöka parametrarnas värden och utföra eventuell förbearbetning före en datahämtningsåtgärd.

För att utföra datahämtningen AccessDataSourceView skapar objektet ett IDbCommand objekt med hjälp av SelectCommand texten och eventuella associerade SelectParameters egenskaper. AccessDataSourceView Sedan kör IDbCommand objektet objektet mot den underliggande datalagringen. När åtgärden har slutförts anropas OnSelected metoden för att skapa Selected händelsen. Du kan hantera Selected händelsen för att undersöka eventuella returvärden och felkoder och utföra eventuell efterbearbetning.

Om egenskapen DataSourceMode är inställd på DataSet värdet och cachelagring är aktiverat AccessDataSourceView hämtar data från och sparar data i cacheminnet under datahämtningen. Cachen skapas, ignoreras eller uppdateras baserat på cachelagringsbeteendet som anges av kombinationen av CacheDuration egenskaperna och CacheExpirationPolicy .

Om egenskapen DataSourceMode är inställd på DataSet värdet och en FilterExpression egenskap har angetts DataSourceMode utvärderas egenskapen tillsammans med eventuella angivna FilterParameters egenskaper och det resulterande filtret tillämpas på listan över data under åtgärden Select .

Gäller för

Se även