ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar data från objektet som identifieras av TypeName egenskapen genom att anropa metoden som identifieras av SelectMethod egenskapen och skicka eventuella värden 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParametrar
- 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 lista över datarader.
Undantag
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.
-eller-
Objektet som returneras av ExecuteSelect(DataSourceSelectArguments) metoden är inte en DataSet eller DataTable, och cachelagring är aktiverat. Endast DataSet och DataTable objekt kan cachelagras för ObjectDataSourceView kontrollen.
-eller-
Både cachelagring och klientpersonifiering är aktiverade. ObjectDataSource Stöder inte cachelagring när klientpersonifiering är aktiverat.
Objektet som returneras av ExecuteSelect(DataSourceSelectArguments) metoden är en DataSet, men har inga tabeller i samlingen Tables .
-eller-
Egenskapen EnablePaging är inställd på true, men StartRowIndexParameterName egenskaperna och MaximumRowsParameterName har inte angetts.
Kommentarer
Klassen ObjectDataSourceView implementerar den ärvda ExecuteSelect metoden för att hämta data med hjälp av ett affärsobjekt. Sidutvecklare och databundna kontrollförfattare anropar ExecuteSelect inte metoden direkt. Använd i stället den offentligt exponerade Select metoden.
Den angivna metoden kan ha valfri metodsignatur, men måste returnera någon av typerna för kontrollen ObjectDataSource som visas i följande tabell för att anropa den.
| Returtyp | Action |
|---|---|
| IEnumerable | IEnumerable Returneras av Select metoden . |
| DataTable | En DataView skapas med hjälp av DataTable och returneras av Select metoden. |
| DataSet | Den första DataTable av DataSet extraheras och en DataView skapas och returneras av Select metoden. |
| Object | Objektet omsluts i ett ett-element IEnumerable och returneras av Select metoden. |
Innan datahämtningen utförs OnSelecting anropas metoden för att skapa Selecting händelsen. Du kan hantera den här händelsen för att undersöka parametrarnas värden och utföra eventuell förbearbetning före en åtgärd.
För att utföra en select-åtgärd ObjectDataSourceView använder kontrollen reflektion för att anropa den metod som identifieras av SelectMethod egenskapen och eventuella associerade parametrar som finns i SelectParameters samlingen och kör den sedan. När åtgärden har slutförts anropas OnSelected metoden för att skapa Selected händelsen. Du kan hantera den här händelsen för att undersöka eventuella returvärden och felkoder och utföra eventuella efterbearbetningar.
Select Om metoden returnerar ett DataSet objekt och cachelagring är aktiverat hämtar data ObjectDataSourceView från och sparar data i cacheminnet under åtgärden. Cachen skapas, ignoreras eller uppdateras baserat på cachelagringsbeteendet som anges av kombinationen av CacheDuration egenskaperna och CacheExpirationPolicy .
Select Om metoden returnerar ett DataSet objekt och en FilterExpression egenskap har angetts utvärderas den tillsammans med eventuella angivna FilterParameters egenskaper och det resulterande filtret tillämpas på listan över data under åtgärdenSelect.
Information om hur du returnerar det valda antalet rader finns i Select.
