AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametri

arguments
DataSourceSelectArguments

Oggetto DataSourceSelectArguments utilizzato per richiedere l'esecuzione di operazioni aggiuntive sui dati oltre al recupero dati di base.

Restituisce

IEnumerable

Oggetto IEnumerable di righe di dati.

Eccezioni

InvalidOperationException

La proprietà DataFile è null o una stringa vuota ("").

NotSupportedException

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 .

Si applica a

Vedi anche