AccessDataSourceView.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'archivio dati sottostante usando la stringa SQL nella SelectCommand proprietà ed eventuali parametri nella SelectParameters raccolta.
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 al recupero dei dati di base.
Restituisce
Oggetto IEnumerable di righe di dati.
Eccezioni
La DataFile proprietà è null o una stringa vuota ("").
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.
Commenti
L'oggetto esegue l'override AccessDataSourceView del ExecuteSelect metodo per assicurarsi che la DataFile proprietà del controllo associato AccessDataSource sia impostata prima di recuperare i dati.
Prima dell'esecuzione del ExecuteSelect metodo, 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 di recupero dei dati.
Per eseguire il recupero dei dati, l'oggetto AccessDataSourceView compila un IDbCommand oggetto utilizzando il SelectCommand testo ed eventuali proprietà associate SelectParameters . L'oggetto esegue quindi AccessDataSourceView l'oggetto IDbCommand sull'archivio dati sottostante. Al termine dell'operazione, viene chiamato il OnSelected metodo per generare l'evento Selected . È possibile gestire l'evento Selected per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.
Se la DataSourceMode proprietà è impostata sul DataSet valore e la memorizzazione nella cache è abilitata, AccessDataSourceView recupera i dati dalla cache e salva i dati nella cache durante l'operazione di recupero dei dati. 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 DataSourceMode proprietà è impostata sul DataSet valore e una FilterExpression proprietà è stata specificata, la DataSourceMode proprietà viene valutata insieme a tutte le proprietà fornite FilterParameters e il filtro risultante viene applicato all'elenco di dati durante l'operazione Select .
