ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) 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'oggetto identificato dalla TypeName proprietà chiamando il metodo identificato dalla SelectMethod proprietà e passando eventuali valori nell'insieme SelectParameters .
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 IEnumerableParametri
- arguments
- DataSourceSelectArguments
Oggetto DataSourceSelectArguments utilizzato per richiedere operazioni sui dati oltre il recupero dei dati di base.
Restituisce
Elenco IEnumerable di righe di dati.
Eccezioni
Il arguments valore passato al ExecuteSelect(DataSourceSelectArguments) metodo specifica che l'origine dati deve eseguire alcune operazioni aggiuntive durante il recupero dei dati per abilitare il paging o l'ordinamento dei dati recuperati, ma il controllo origine dati non supporta la funzionalità richiesta.
oppure
L'oggetto restituito dal ExecuteSelect(DataSourceSelectArguments) metodo non è o DataSetDataTablee la memorizzazione nella cache è abilitata. Solo DataSet gli oggetti e DataTable possono essere memorizzati nella cache per il ObjectDataSourceView controllo .
oppure
La memorizzazione nella cache e la rappresentazione client sono abilitate. ObjectDataSource non supporta la memorizzazione nella cache quando la rappresentazione client è abilitata.
L'oggetto ExecuteSelect(DataSourceSelectArguments) restituito dal metodo è , DataSetma non contiene tabelle nella relativa Tables raccolta.
oppure
La EnablePaging proprietà è impostata su true, ma le StartRowIndexParameterName proprietà e MaximumRowsParameterName non sono impostate.
Commenti
La ObjectDataSourceView classe implementa il metodo ereditato ExecuteSelect per recuperare i dati usando un oggetto business. Gli sviluppatori di pagine e gli autori di controlli associati a dati non chiamano direttamente il ExecuteSelect metodo. Usare invece il metodo esposto Select pubblicamente.
Il metodo specificato può avere qualsiasi firma del metodo, ma deve restituire uno dei tipi per il ObjectDataSource controllo elencato nella tabella seguente per chiamarlo 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 . |
| 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 un elemento IEnumerable e restituito dal Select metodo . |
Prima di eseguire il recupero dei dati, viene chiamato il OnSelecting metodo per generare l'evento Selecting . È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un'operazione.
Per eseguire un'operazione di selezione, il controllo usa la ObjectDataSourceView reflection per chiamare il metodo identificato dalla SelectMethod proprietà ed eventuali parametri associati presenti nell'insieme SelectParameters e quindi lo esegue. Al termine dell'operazione, viene chiamato il OnSelected metodo per generare l'evento Selected . È possibile gestire questo evento per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.
Se il Select metodo restituisce un DataSet oggetto e la memorizzazione nella cache è abilitata, ObjectDataSourceView recupera i dati da e salva i dati nella cache durante l'operazione. La cache viene creata, eliminata o aggiornata in base al comportamento di memorizzazione nella cache specificato dalla combinazione delle CacheDuration proprietà e CacheExpirationPolicy .
Se il Select metodo restituisce un DataSet oggetto e una FilterExpression proprietà è stata specificata, viene valutata FilterParameters insieme a tutte le proprietà fornite e il filtro risultante viene applicato all'elenco di dati durante l'operazione Select .
Per informazioni sulla restituzione del numero di righe selezionate, vedere Select.
