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 proprietà SelectMethod con i parametri nell'insieme SelectParameters.
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 essere restituita o derivata da uno dei tipi elencati nella tabella seguente per il ObjectDataSource controllo da chiamare correttamente.
| Tipo restituito | Azione |
|---|---|
| IEnumerable | Viene IEnumerable restituito dal Select metodo . |
| DataTable | Viene DataView creato usando il DataTable metodo e restituito dal Select metodo . |
| DataView | Viene DataView 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 eseguito il wrapping in una raccolta di elementi IEnumerable uno 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 ogni volta che viene chiamato il metodo specificato dalla SelectMethod proprietà, ad eccezione del fatto che la stessa istanza viene usata per chiamare il metodo specificato dalla proprietà e dal metodo specificato dalla SelectMethodSelectCountMethod proprietà . Il metodo restituisce un'interfaccia SelectIEnumerable . Tuttavia, per abilitare scenari di memorizzazione nella cache e filtro, il valore restituito deve essere un DataSet oggetto. Anche se la DataSet classe non implementa l'interfacciaIEnumerable, 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 ObjectDataSourceView usa la reflection per creare un'istanza dell'oggetto TypeName identificato dalla proprietà . Chiama quindi il metodo identificato dalla SelectMethod proprietà usando le proprietà associate SelectParameters . Al termine dell'operazione Select , il OnSelected metodo viene chiamato 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 proprietà restituisce un oggetto , DataTableo o DataView e la SelectMethod memorizzazione nella cache è abilitata, i ObjectDataSource dati vengono recuperati e salvati nella cache durante l'operazioneSelect.DataSet La cache viene creata, eliminata o aggiornata in base al comportamento di memorizzazione nella cache specificata 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 con le proprietà fornite FilterParameters 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 dell'oggetto e sulla risoluzione dei metodi, vedere SelectMethod.
controlli Data-Bound
Quando il ObjectDataSource controllo è associato a un controllo associato a dati, ad esempio il controllo, non è necessario chiamare il SelectGridView metodo dal codice della pagina. Il Select metodo viene richiamato direttamente dal controllo associato ai dati.
