ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Method

Definizione

Recupera dati dall'oggetto identificato dalla proprietà TypeName chiamando il metodo identificato dalla proprietà SelectMethod e passando i valori nell'insieme SelectParameters.Retrieves data from the object that is identified by the TypeName property by calling the method that is identified by the SelectMethod property and passing any values in the SelectParameters collection.

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 DataSourceSelectArguments DataSourceSelectArguments DataSourceSelectArguments

Oggetto DataSourceSelectArguments utilizzato per richiedere l'esecuzione di operazioni aggiuntive sui dati oltre al recupero dati di base.A DataSourceSelectArguments used to request operations on the data beyond basic data retrieval.

Restituisce

Elenco IEnumerable di righe di dati.A IEnumerable list of data rows.

Eccezioni

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.The arguments passed to the ExecuteSelect(DataSourceSelectArguments) method specify that the data source should perform some additional work while retrieving data to enable paging or sorting through the retrieved data, but the data source control does not support the requested capability.

-oppure--or- L'oggetto restituito dal metodo ExecuteSelect(DataSourceSelectArguments) non è DataSet o DataTable ed è abilitata la memorizzazione nella cache.The object returned by the ExecuteSelect(DataSourceSelectArguments) method is not a DataSet or DataTable, and caching is enabled. Solo gli oggetti DataSet e DataTable possono essere memorizzati nella cache per il controllo ObjectDataSourceView.Only DataSet and DataTable objects can be cached for the ObjectDataSourceView control.

-oppure--or- Sono abilitate sia la memorizzazione nella cache che la rappresentazione del client.Both caching and client impersonation are enabled. L'oggetto ObjectDataSource non supporta la memorizzazione nella cache quando è abilitata la rappresentazione del client.The ObjectDataSource does not support caching when client impersonation is enabled.

L'oggetto restituito dal metodo ExecuteSelect(DataSourceSelectArguments) è un oggettoDataSet, ma non presenta tabelle nel relativo insieme Tables.The object returned by the ExecuteSelect(DataSourceSelectArguments) method is a DataSet, but has no tables in its Tables collection.

In alternativa-or- La proprietà EnablePaging è impostata su true, ma le proprietà StartRowIndexParameterName e MaximumRowsParameterName non sono impostate.The EnablePaging property is set to true, but the StartRowIndexParameterName and MaximumRowsParameterName properties are not set.

Commenti

La ObjectDataSourceView classe implementa il metodo ExecuteSelect ereditato per recuperare i dati utilizzando un oggetto business.The ObjectDataSourceView class implements the inherited ExecuteSelect method to retrieve data using a business object. Gli sviluppatori di pagine e gli autori di controlli con associazione a ExecuteSelect dati non chiamano direttamente il metodo; usare invece Select il metodo esposto pubblicamente.Page developers and data-bound control authors do not call the ExecuteSelect method directly; instead, use the publicly exposed Select method.

Il metodo specificato può avere una firma del metodo, ma deve restituire uno dei tipi per il ObjectDataSource controllo elencato nella tabella seguente per chiamarlo correttamente.The specified method can have any method signature, but must return one of the types for the ObjectDataSource control that are listed in the following table to call it successfully.

Tipo restituitoReturn type OperazioneAction
IEnumerable IEnumerable Viene restituitoSelect dal metodo.The IEnumerable is returned by the Select method.
DataTable Un DataView oggetto viene creato DataTable usando e restituito dal Select metodo.A DataView is created using the DataTable and returned by the Select method.
DataSet Il primo DataTable DataSet oggetto di viene estratto e un DataView oggetto viene creato e restituito dal Select metodo.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object L'oggetto viene racchiuso in un elemento IEnumerable e restituito Select dal metodo.The object is wrapped in a one-element IEnumerable and returned by the Select method.

Prima di eseguire il recupero dei dati, viene OnSelecting chiamato il metodo per generare l' Selecting evento.Before the data retrieval is performed, the OnSelecting method is called to raise the Selecting event. È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un'operazione.You can handle this event to examine the values of the parameters and to perform any preprocessing before an operation.

Per eseguire un'operazione Select, il ObjectDataSourceView controllo Usa la reflection per chiamare il metodo identificato SelectMethod dalla proprietà e gli eventuali SelectParameters parametri associati presenti nella raccolta e quindi li esegue.To perform a select operation, the ObjectDataSourceView control uses reflection to call the method that is identified by the SelectMethod property and any associated parameters that are in the SelectParameters collection, and then executes it. Al termine dell'operazione, viene chiamato OnSelected il metodo per generare l' Selected evento.After the operation completes, the OnSelected method is called to raise the Selected event. È possibile gestire questo evento per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.You can handle this event to examine any return values and error codes, and to perform any post-processing.

Se il Select metodo restituisce un DataSet oggetto e la memorizzazione nella cache è abilitata, ObjectDataSourceView recupera i dati da e salva i dati nella cache durante l'operazione.If the Select method returns a DataSet object and caching is enabled, the ObjectDataSourceView retrieves data from and saves data to the cache during the operation. La cache viene creata, eliminata o aggiornata in base al comportamento di memorizzazione nella cache specificato dalla combinazione delle CacheDuration proprietà e. CacheExpirationPolicyThe cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Se il Select metodo restituisce un DataSet oggetto ed è FilterExpression stata specificata una proprietà, viene valutato insieme a tutte le proprietà FilterParameters fornite e il filtro risultante viene applicato all'elenco di dati durante l' Select operazione.If the Select method returns a DataSet object and a FilterExpression property has been specified, it is evaluated along with any supplied FilterParameters properties and the resulting filter is applied to the list of data during the Select operation.

Per informazioni sulla restituzione del numero di righe selezionato, Selectvedere.For information on returning the number of rows selected, see Select.

Si applica a

Vedi anche