ObjectDataSource.Select 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 den underliggande datalagringen genom att anropa metoden som identifieras av SelectMethod egenskapen med parametrarna SelectParameters i samlingen.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableReturer
En IEnumerable lista över datarader.
Exempel
Ett kodexempel finns i ObjectDataSource.
Kommentarer
Den angivna metoden kan ha valfri metodsignatur, men den måste returneras eller härledas från någon av de typer som anges i följande tabell för att kontrollen ska kunna anropa den ObjectDataSource .
| Returtyp | Action |
|---|---|
| IEnumerable | IEnumerable Returneras av Select metoden . |
| DataTable | A DataView skapas med hjälp DataTable av och returneras av Select metoden. |
| DataView | DataView 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 en samling med ett element IEnumerable och returneras av Select metoden. |
Den metod som identifieras av egenskapen SelectMethod kan vara en instansmetod eller en static -metod (Shared i Visual Basic). Om det är en instansmetod skapas och förstörs affärsobjektet varje gång metoden som anges av SelectMethod egenskapen anropas, förutom att samma instans används för att anropa den metod som anges av SelectMethod egenskapen och metoden som anges av SelectCountMethod egenskapen. Metoden Select returnerar ett IEnumerable gränssnitt. Men för att aktivera cachelagrings- och filtreringsscenarier måste returvärdet vara ett DataSet objekt.
DataSet Klassen implementerar IEnumerable inte gränssnittet, ObjectDataSource men kontrollen extraherar automatiskt standardkontrollenDataView, som implementerar IEnumerable.
Innan åtgärden Select utförs OnSelecting anropas metoden för att skapa 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 Select åtgärd. För att utföra en datahämtningsåtgärd ObjectDataSourceView använder objektet reflektion för att skapa en instans av objektet som identifieras av TypeName egenskapen. Den anropar sedan den metod som identifieras av egenskapen med hjälp av SelectMethod associerade SelectParameters egenskaper. När åtgärden Select 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, utdataparametrar och undantag och utföra eventuella efterbearbetningar.
Om egenskapen SelectMethod returnerar ett DataSet, DataTableeller DataView -objekt och cachelagring är aktiverat, ObjectDataSource hämtar data från och sparar data i cacheminnet under åtgärden Select . Cachen skapas, ignoreras eller uppdateras baserat på cachelagringsbeteendet som anges av kombinationen av CacheDuration egenskaperna och CacheExpirationPolicy .
Om egenskapen SelectMethod returnerar ett DataSet eller DataTable -objekt och en FilterExpression egenskap har angetts utvärderas den med alla angivna FilterParameters egenskaper och det resulterande filtret tillämpas på listan över data under åtgärden Select .
Metoden Select delegerar till Select metoden ObjectDataSourceView för den som är associerad med ObjectDataSource kontrollen.
Mer information om parametersammanslagningen, objektets livslängd och metodmatchning finns i SelectMethod.
Data-Bound kontroller
När kontrollen ObjectDataSource är associerad med en databunden kontroll, till exempel GridView kontrollen, är det inte nödvändigt att anropa Select metoden från sidkoden. Metoden Select anropas direkt av den databundna kontrollen i stället.
