ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metodo

  • Riferimento

Definizione

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

Recupera dati dall'oggetto identificato dalla proprietà TypeName chiamando il metodo identificato dalla proprietà SelectMethod e passando i 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.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

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-

L'oggetto restituito dal metodo ExecuteSelect(DataSourceSelectArguments) non è DataSet o DataTable ed è abilitata la memorizzazione nella cache. Solo gli oggetti DataSet e DataTable possono essere memorizzati nella cache per il controllo ObjectDataSourceView.

-oppure-

Sono abilitate sia la memorizzazione nella cache che la rappresentazione del client. L'oggetto ObjectDataSource non supporta la memorizzazione nella cache quando è abilitata la rappresentazione del client.

InvalidOperationException

L'oggetto restituito dal metodo ExecuteSelect(DataSourceSelectArguments) è un oggettoDataSet, ma non presenta tabelle nel relativo insieme Tables.

-oppure-

La proprietà EnablePaging è impostata su true, ma le proprietà StartRowIndexParameterName 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, ma usano 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 Azione
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 dell'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 ObjectDataSourceView controllo usa la reflection per chiamare il metodo identificato dalla SelectMethod proprietà e tutti i 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, recupera ObjectDataSourceView 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 insieme a tutte le proprietà fornite FilterParameters 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.

Si applica a

Vedi anche