ObjectDataSource.Select Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera i dati dall'archivio dati sottostante chiamando il metodo identificato dalla SelectMethod proprietà con i parametri nella SelectParameters raccolta.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableRestituisce
Elenco IEnumerable di righe di dati.
Esempio
Per un esempio di codice, vedere ObjectDataSource.
Commenti
Il metodo specificato potrebbe avere una firma del metodo, ma deve restituire o derivare da uno dei tipi elencati nella tabella seguente affinché il ObjectDataSource controllo lo chiami correttamente.
| Tipo restituito | Action |
|---|---|
| IEnumerable | L'oggetto IEnumerable viene restituito dal Select metodo . |
| DataTable | Un DataView oggetto viene creato utilizzando DataTable e restituito dal Select metodo . |
| DataView | L'oggetto DataView viene restituito dal Select metodo . |
| DataSet | Il primo DataTable oggetto DataSet viene estratto e viene DataView creato e restituito dal Select metodo . |
| Object | L'oggetto viene sottoposto a wrapping in una raccolta di un elemento IEnumerable e restituito dal Select metodo . |
Il metodo identificato dalla SelectMethod proprietà può essere un metodo di istanza o un static metodo (Shared in Visual Basic). Se si tratta di un metodo di istanza, l'oggetto business viene creato e eliminato definitivamente ogni volta che viene chiamato il metodo specificato dalla SelectMethod proprietà , ad eccezione del fatto che la stessa istanza viene utilizzata per chiamare il metodo specificato dalla SelectMethod proprietà e il metodo specificato dalla SelectCountMethod proprietà . Il Select metodo restituisce un'interfaccia IEnumerable . Tuttavia, per abilitare la memorizzazione nella cache e gli scenari di filtro, il valore restituito deve essere un DataSet oggetto . Anche se la DataSet classe non implementa l'interfaccia IEnumerable , il ObjectDataSource controllo estrae automaticamente il controllo predefinitoDataView, che implementa .IEnumerable
Prima di eseguire l'operazione Select , viene chiamato il OnSelecting metodo per generare l'evento Selecting . È possibile gestire l'evento Selecting per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un'operazione Select . Per eseguire un'operazione di recupero dati, l'oggetto utilizza la ObjectDataSourceView reflection per creare un'istanza dell'oggetto identificato dalla TypeName proprietà . Chiama quindi il metodo identificato dalla SelectMethod proprietà , utilizzando le proprietà associate SelectParameters . Al termine dell'operazione Select , viene chiamato il OnSelected metodo per generare l'evento Selected . È possibile gestire l'evento Selected per esaminare i valori restituiti, i parametri di output e le eccezioni e per eseguire qualsiasi post-elaborazione.
Se la SelectMethod proprietà restituisce un DataSetoggetto , DataTableo DataView e la memorizzazione nella cache è abilitata, recupera ObjectDataSource i dati da e salva nella cache durante l'operazione Select . La cache viene creata, eliminata o aggiornata in base al comportamento di memorizzazione nella cache specificato dalla combinazione delle CacheDuration proprietà e CacheExpirationPolicy .
Se la SelectMethod proprietà restituisce un DataSet oggetto o DataTable e una FilterExpression proprietà è stata specificata, viene valutata FilterParameters con le proprietà fornite e il filtro risultante viene applicato all'elenco di dati durante l'operazione Select .
Il Select metodo delega al Select metodo dell'oggetto ObjectDataSourceView associato al ObjectDataSource controllo .
Per altre informazioni sull'unione dei parametri, sulla durata degli oggetti e sulla risoluzione dei metodi, vedere SelectMethod.
controlli Data-Bound
Quando il ObjectDataSource controllo è associato a un controllo associato a dati, ad esempio il GridView controllo , non è necessario chiamare il Select metodo dal codice della tabella. Il Select metodo viene richiamato direttamente dal controllo associato a dati.
