SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metodo

  • Riferimento

Definizione

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

Recupera dati dal database sottostante utilizzando la stringa SQL SelectCommand e tutti 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 sui dati oltre al recupero dati di base.

Restituisce

IEnumerable

Elenco IEnumerable di righe di dati.

Eccezioni

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.

-oppure-

La memorizzazione nella cache è abilitata ma la proprietà DataSourceMode dell'origine dati non è impostata su DataSet.

-oppure-

La proprietà SortParameterName è impostata ma CommandType non è impostato su StoredProcedure.

InvalidOperationException

L'origine dati non può creare una connessione al database.

-oppure-

La memorizzazione nella cache è abilitata ma la cache interna e i tipi di comandi non corrispondono.

Commenti

La SqlDataSourceView classe implementa il metodo ereditato ExecuteSelect per recuperare i dati da un database. Gli sviluppatori di pagine e gli autori di controlli associati ai dati non chiamano direttamente il metodo. Usare invece il ExecuteSelect metodo esposto Select pubblicamente.

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 che vengano recuperati i dati.

Per eseguire l'operazione, l'oggetto SqlDataSourceView compila un DbCommand oggetto usando il SelectCommand testo e qualsiasi oggetto associato SelectParameterse lo esegue nel database sottostante. Al termine dell'operazione, il OnSelected metodo viene chiamato per generare l'evento Selected . È possibile gestire questo evento per esaminare i valori restituiti, i codici di errore ed eseguire qualsiasi post-elaborazione.

Il ExecuteSelect metodo restituisce un DataView oggetto se è DataSourceMode impostato su DataSeto un IDataReader oggetto se è DataSourceMode impostato su DataReader. Chiudere l'oggetto IDataReader al termine della lettura dei dati.

Se l'oggetto DataSourceMode è impostato su DataSet e la memorizzazione nella cache è abilitato, i SqlDataSourceView dati vengono recuperati e salvati nella cache durante l'operazione di dati. La cache viene creata, eliminata o aggiornata in base al comportamento di memorizzazione nella cache specificata dalla combinazione delle CacheDuration proprietà e CacheExpirationPolicy .

Importante

Quando si usa la rappresentazione client in autenticazione di Windows, i dati vengono memorizzati nella cache quando il primo utente accede ai dati. Se un altro utente richiede gli stessi dati, i dati vengono recuperati dalla cache. I dati non vengono recuperati eseguendo un'altra chiamata al database per verificare l'accesso dell'utente ai dati. Se si prevede che più utenti accedono ai dati e si desidera che ogni recupero ai dati venga verificato dalle configurazioni di sicurezza del database, non usare la memorizzazione nella cache.

Se l'oggetto DataSourceMode è impostato su e è FilterExpression stato specificato, viene valutato insieme a DataSet qualsiasi elemento fornito FilterParameters e il filtro risultante viene applicato all'elenco di dati durante l'operazione di recupero dei dati.

Si applica a

Vedi anche