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 utilizzando la stringa SQL nella proprietà SelectCommand e i parametri dell'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 l'esecuzione di operazioni aggiuntive sui dati oltre al recupero dati di base.
Restituisce
Oggetto IEnumerable di righe di dati.
Eccezioni
La proprietà DataFile è null o una stringa vuota ("").
Mediante gli arguments passati al metodo ExecuteSelect(DataSourceSelectArguments) è possibile specificare che l'origine dati deve eseguire operazioni aggiuntive durante il recupero dei dati per consentire il paging o l'ordinamento dei dati recuperati; tuttavia la funzionalità richiesta non è supportata dal controllo origine dati.
Commenti
L'oggetto AccessDataSourceView esegue l'override del ExecuteSelect metodo per assicurarsi che la DataFile proprietà del relativo controllo associato AccessDataSource sia impostata prima di recuperare i dati.
Prima dell'esecuzione del metodo, viene chiamato il ExecuteSelectOnSelecting 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 usando il SelectCommand testo e le proprietà associate SelectParameters . L'oggetto AccessDataSourceView esegue quindi l'oggetto nell'archivio IDbCommand dati sottostante. Al termine dell'operazione, il OnSelected metodo viene chiamato 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 proprietà è impostata sul DataSet valore e la DataSourceMode memorizzazione nella cache è abilitata, i AccessDataSourceView dati vengono recuperati e salvati 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 è stata specificata una FilterExpression proprietà, 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 .
