Condividi tramite


ObjectDataSourceView Classe

Definizione

Supporta il controllo ObjectDataSource e fornisce un'interfaccia per i controlli associati a dati per l'esecuzione di operazioni sui dati con oggetti business e dati.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager
public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager
type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager
Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager
Ereditarietà
ObjectDataSourceView
Implementazioni

Commenti

La ObjectDataSourceView classe è destinata principalmente a essere usata dai controlli associati ai dati e non come oggetto programmabile nel codice della pagina.

La ObjectDataSourceView classe implementa le funzionalità dei dati per il controllo, tra cui le Selectoperazioni , , UpdateDeleteeInsert, l'ordinamento, il ObjectDataSource filtro e la gestione delle impostazioni mantenute nello stato di visualizzazione.

Un ObjectDataSourceView oggetto viene creato per ogni istanza della ObjectDataSource classe in fase di esecuzione. Le chiamate ai dati dell'istanza della ObjectDataSource classe vengono gestite dall'istanza dell'oggetto ObjectDataSourceView . Gli sviluppatori di pagine non accedono direttamente all'istanza della ObjectDataSourceView classe . Gli sviluppatori di controlli possono creare controlli dati personalizzati estendendo le ObjectDataSource classi e ObjectDataSourceView .

La ObjectDataSourceView classe esegue operazioni sui dati chiamando metodi su oggetti business o dati tramite reflection. In fase di esecuzione, il ObjectDataSource controllo crea un'istanza del tipo identificato dalla TypeName proprietà e quindi chiama il metodo appropriato per l'operazione dati. L'oggetto di cui è stata creata un'istanza non viene memorizzato nella cache da ObjectDataSourceView. L'oggetto viene creato e eliminato definitivamente per ogni chiamata al metodo dati. Se il metodo è static (Shared in Visual Basic), non viene creata un'istanza ma viene comunque chiamato il metodo dell'operazione dati.

l'oggetto ObjectDataSourceView non è esposto direttamente agli sviluppatori di pagine dal ObjectDataSource controllo . Le proprietà e i metodi di sono ObjectDataSourceView invece accessibili tramite .ObjectDataSource Ad esempio, la DeleteMethod proprietà della ObjectDataSourceView proprietà viene impostata impostando la DeleteMethod proprietà dell'oggetto ObjectDataSource.

Recupero di dati

L'operazione più semplice eseguita da una vista origine dati è il recupero dei dati dall'archivio dati sottostante tramite il Select metodo , che recupera una IEnumerable raccolta di elementi di dati. I metodi, le proprietà e gli eventi di recupero dati seguenti vengono implementati dall'oggetto ObjectDataSourceView ed esposti direttamente dal ObjectDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

Aggiornamento dei dati

L'oggetto ObjectDataSourceView supporta gli aggiornamenti dei dati chiamando un metodo business o oggetto dati identificato dalla UpdateMethod proprietà . I controlli associati a dati che eseguono automaticamente aggiornamenti, ad esempio i GridView controlli e DetailsView , passano i relativi parametri in un'interfaccia IOrderedDictionary all'oggetto ObjectDataSourceView e l'oggetto visualizzazione unisce questi parametri con tutti i parametri presenti nell'insieme UpdateParameters .

I metodi di aggiornamento, le proprietà e gli eventi seguenti vengono implementati da ObjectDataSourceView e esposti direttamente dal ObjectDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

Inserimento di dati

L'oggetto supporta l'inserimento ObjectDataSourceView di nuove righe di dati chiamando un metodo business o oggetto dati identificato dalla InsertMethod proprietà . I controlli associati a dati che eseguono automaticamente inserimenti, ad esempio GridView e DetailsView, passano i relativi parametri in un'interfaccia IOrderedDictionary all'oggetto ObjectDataSourceView e l'oggetto view unisce questi parametri con tutti i parametri presenti nell'insieme InsertParameters .

I metodi di inserimento, le proprietà e gli eventi seguenti vengono implementati da ObjectDataSourceView e esposti direttamente dal ObjectDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

Eliminazione di dati

L'oggetto supporta l'eliminazione ObjectDataSourceView di dati chiamando un metodo business o oggetto dati identificato dalla DeleteMethod proprietà . I controlli associati a dati che eseguono automaticamente eliminazioni, ad esempio GridView e DetailsView, passano i relativi parametri in un'interfaccia IOrderedDictionary all'oggetto ObjectDataSourceView e l'oggetto view unisce questi parametri con tutti i parametri presenti nell'insieme DeleteParameters . I metodi di eliminazione, le proprietà e gli eventi seguenti vengono implementati da ObjectDataSourceView e esposti direttamente dal ObjectDataSource controllo agli sviluppatori di pagine e ad altri chiamanti:

Filtro e ordinamento di dati

Il recupero dei dati è più potente quando è possibile filtrare i dati in modo dinamico. Il filtro è supportato solo dal ObjectDataSource controllo se il Select metodo restituisce un DataTable oggetto o DataSet . È possibile usare le FilterExpression proprietà e FilterParameters per applicare il filtro dinamico al recupero dei dati. Queste proprietà vengono implementate dall'oggetto ObjectDataSourceView ed esposte direttamente dal controllo ObjectDataSource ai controlli associati a dati e ad altri chiamanti.

È possibile ordinare i dati recuperati con ObjectDataSource ordinando i dati in memoria dopo il recupero. L'ordinamento ObjectDataSource è supportato solo dal controllo se il Select metodo restituisce un DataTable oggetto o DataSet. La CanSort proprietà restituisce truesempre , perché non ObjectDataSourceView è in grado di determinare il Select tipo restituito dal metodo senza chiamare il metodo . La sintassi della SortExpression proprietà è uguale a quella di una DataView.Sort proprietà.

Stato visualizzazione rilevamento

ObjectDataSourceView Implementa l'interfaccia IStateManager e usa lo stato di visualizzazione per tenere traccia dello stato tra le richieste di pagina. L'implementazione dei LoadViewStatemetodi , SaveViewStatee TrackViewState viene fornita per abilitare il rilevamento dello stato di visualizzazione per il controllo . Per altre informazioni, vedere panoramica di gestione dello stato di ASP.NET.

Costruttori

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inizializza una nuova istanza della classe ObjectDataSourceView.

Proprietà

CanDelete

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato all'oggetto ObjectDataSource corrente supporta l'operazione di eliminazione.

CanInsert

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo ObjectDataSource corrente supporta l'operazione di inserimento.

CanPage

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo ObjectDataSource corrente supporta il paging dei dati recuperati.

CanRetrieveTotalRowCount

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo ObjectDataSource corrente supporta il recupero del numero totale di righe di dati, oltre all'insieme di dati.

CanSort

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo ObjectDataSource corrente supporta una visualizzazione ordinata dell'origine dati sottostante.

CanUpdate

Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo ObjectDataSource corrente supporta l'operazione di aggiornamento.

ConflictDetection

Ottiene o imposta un valore che determina come il controllo ObjectDataSource esegue aggiornamenti ed eliminazioni quando i dati in una riga dell'archivio dati sottostante vengono modificati durante l'operazione.

ConvertNullToDBNull

Ottiene o imposta un valore indicante se i valori Parameter passati a un'operazione di aggiornamento, inserimento o eliminazione vengono automaticamente convertiti da null nel valore Value.

DataObjectTypeName

Ottiene o imposta il nome di una classe utilizzata dal controllo ObjectDataSource per un parametro in un'operazione sui dati. Il controllo ObjectDataSource utilizza la classe specificata anziché gli oggetti Parameter contenuti nei vari insiemi di parametri.

DeleteMethod

Ottiene o imposta il nome del metodo o funzione che l'oggetto ObjectDataSourceView richiama per eliminare i dati.

DeleteParameters

Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo DeleteMethod.

EnablePaging

Ottiene o imposta un valore indicante se il controllo origine dati supporta il paging dell'insieme di dati recuperati.

Events

Ottiene un elenco di delegati del gestore eventi per la visualizzazione origine dati.

(Ereditato da DataSourceView)
FilterExpression

Ottiene o imposta un'espressione di filtro applicata quando il metodo dell'oggetto business identificato dalla proprietà SelectMethod viene chiamato.

FilterParameters

Ottiene un insieme di parametri associati a tutti i segnaposto di parametro nella stringa FilterExpression.

InsertMethod

Ottiene o imposta il nome del metodo o funzione che l'oggetto ObjectDataSourceView richiama per inserire i dati.

InsertParameters

Ottiene l'insieme di parametri contenente i parametri utilizzati dal metodo InsertMethod.

IsTrackingViewState

Ottiene un valore che indica se l'oggetto ObjectDataSourceView sta salvando le modifiche apportate al relativo stato di visualizzazione.

MaximumRowsParameterName

Ottiene o imposta il nome di parametro del metodo di recupero dati utilizzato per indicare il numero di record da recuperare per il supporto paging dell'origine dati.

Name

Ottiene il nome della visualizzazione origine dati.

(Ereditato da DataSourceView)
OldValuesParameterFormatString

Ottiene o imposta una stringa di formato da applicare ai nomi dei parametri per i valori originali passati ai metodi Delete o Update.

ParsingCulture

Ottiene un oggetto o imposta un valore che indica le informazioni sulle impostazioni cultura utilizzate quando si convertono i valori stringa in tipi di proprietà effettivi per costruire un oggetto del tipo indicato da DataObjectTypeName.

SelectCountMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSourceView richiama per recuperare un numero di righe.

SelectMethod

Ottiene o imposta il nome del metodo o funzione che il controllo ObjectDataSourceView richiama per recuperare i dati.

SelectParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dal metodo SelectMethod.

SortParameterName

Ottiene o imposta il nome di parametro del metodo di recupero dati utilizzato per specificare un'espressione di ordinamento per il supporto di ordinamento dell'origine dati.

StartRowIndexParameterName

Ottiene o imposta il nome di parametro del metodo di recupero dati utilizzato per indicare l'indice integer del primo record da recuperare dall'insieme di risultati per il supporto paging dell'origine dati.

TypeName

Ottiene o imposta il nome della classe rappresentata dal controllo ObjectDataSource.

UpdateMethod

Ottiene o imposta il nome del metodo o funzione che l'oggetto ObjectDataSourceView richiama per aggiornare i dati.

UpdateParameters

Ottiene l'insieme di parametri che contiene i parametri utilizzati dal metodo UpdateMethod.

Metodi

CanExecute(String)

Determina se è possibile eseguire il comando specificato.

(Ereditato da DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di eliminazione asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)
Delete(IDictionary, IDictionary)

Esegue un'operazione di eliminazione chiamando il metodo dell'oggetto business identificato dalla proprietà DeleteMethod utilizzando gli insiemi keys e oldValues specificati.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue il comando specificato.

(Ereditato da DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)

Esegue il comando specificato.

(Ereditato da DataSourceView)
ExecuteDelete(IDictionary, IDictionary)

Esegue un'operazione di eliminazione utilizzando il metodo DeleteMethod e l'insieme keys e oldValues specificato.

ExecuteInsert(IDictionary)

Esegue un'operazione di inserimento chiamando il metodo dell'oggetto business identificato dalla proprietà InsertMethod utilizzando l'insieme values specificato.

ExecuteSelect(DataSourceSelectArguments)

Recupera dati dall'oggetto identificato dalla proprietà TypeName chiamando il metodo identificato dalla proprietà SelectMethod e passando i valori nell'insieme SelectParameters.

ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e utilizzando tutti i parametri forniti negli insiemi keys, values o oldValues.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Insert(IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di inserimento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)
Insert(IDictionary)

Esegue un'operazione di inserimento chiamando il metodo dell'oggetto business identificato dalla proprietà InsertMethod utilizzando l'insieme values specificato.

LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato per la visualizzazione origine dati.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnDataSourceViewChanged(EventArgs)

Genera l'evento DataSourceViewChanged.

(Ereditato da DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)

Genera l'evento Deleted quando il l'oggetto ObjectDataSourceView completa un'operazione di eliminazione.

OnDeleting(ObjectDataSourceMethodEventArgs)

Genera l'evento Deleting prima che l'oggetto ObjectDataSourceView tenti di eseguire un'operazione di eliminazione.

OnFiltering(ObjectDataSourceFilteringEventArgs)

Genera l'evento Filtering prima che l'oggetto ObjectDataSourceView tenti di eseguire un'operazione di filtraggio.

OnInserted(ObjectDataSourceStatusEventArgs)

Genera l'evento Inserted quando l'oggetto ObjectDataSourceView completa un'operazione di inserimento.

OnInserting(ObjectDataSourceMethodEventArgs)

Genera l'evento Inserting prima che l'oggetto ObjectDataSourceView tenti di eseguire un'operazione di inserimento.

OnObjectCreated(ObjectDataSourceEventArgs)

Genera l'evento ObjectCreated una volta che l'oggetto ObjectDataSourceView crea un'istanza dell'oggetto identificato dalla proprietà TypeName.

OnObjectCreating(ObjectDataSourceEventArgs)

Genera l'evento ObjectCreating prima che l'oggetto ObjectDataSourceView crei un'istanza di un oggetto business per l'esecuzione di un'operazione sui dati.

OnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Genera l'evento ObjectDisposing prima che l'oggetto ObjectDataSourceView elimini un tipo con istanze.

OnSelected(ObjectDataSourceStatusEventArgs)

Genera l'evento Selected quando l'oggetto ObjectDataSourceView completa un'operazione di recupero dati.

OnSelecting(ObjectDataSourceSelectingEventArgs)

Genera l'evento Selecting prima che l'oggetto ObjectDataSourceView tenti di eseguire un'operazione di recupero dati.

OnUpdated(ObjectDataSourceStatusEventArgs)

Genera l'evento Updated quando l'oggetto ObjectDataSourceView completa un'operazione di aggiornamento.

OnUpdating(ObjectDataSourceMethodEventArgs)

Genera l'evento Updating prima che l'oggetto ObjectDataSourceView tenti di eseguire un'operazione di aggiornamento.

RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Viene chiamato dal metodo RaiseUnsupportedCapabilitiesError(DataSourceView) per confrontare le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) con quelle supportate dalla visualizzazione.

(Ereditato da DataSourceView)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto ObjectDataSourceView dal momento in cui è stato eseguito il postback della pagina al server.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Ottiene un elenco di dati dall'archivio dati sottostante in modo asincrono.

(Ereditato da DataSourceView)
Select(DataSourceSelectArguments)

Recupera dati dall'oggetto identificato dalla proprietà TypeName chiamando il metodo identificato dalla proprietà SelectMethod e passando i valori nell'insieme SelectParameters.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TrackViewState()

Fa in modo che l'oggetto ObjectDataSourceView tenga traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere archiviate nell'oggetto ViewState del controllo e mantenute nelle richieste della stessa pagina.

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Esegue un'operazione di aggiornamento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView.

(Ereditato da DataSourceView)
Update(IDictionary, IDictionary, IDictionary)

Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e utilizzando tutti i parametri forniti negli insiemi keys, values o oldValues.

Eventi

DataSourceViewChanged

Si verifica quando la visualizzazione origine dati ha subito una modifica.

(Ereditato da DataSourceView)
Deleted

Si verifica quando viene completata un'operazione Delete.

Deleting

Si verifica prima di un'operazione Delete.

Filtering

Si verifica prima di un'operazione di filtro.

Inserted

Si verifica quando viene completata un'operazione Insert.

Inserting

Si verifica prima di un'operazione Insert.

ObjectCreated

Si verifica una volta che l'oggetto ObjectDataSourceView crea un'istanza del tipo identificato dalla proprietà TypeName.

ObjectCreating

Si verifica prima che l'oggetto ObjectDataSourceView crei un'istanza del tipo identificato dalla proprietà TypeName.

ObjectDisposing

Si verifica quando l'oggetto ObjectDataSourceView elimina un'istanza di un oggetto creato.

Selected

Si verifica quando viene completata un'operazione di recupero.

Selecting

Si verifica prima di un'operazione di recupero dati.

Updated

Si verifica quando viene completata un'operazione Update.

Updating

Si verifica prima di un'operazione Update.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState

Per una descrizione di questo membro, vedere IsTrackingViewState.

IStateManager.LoadViewState(Object)

Per una descrizione di questo membro, vedere LoadViewState(Object).

IStateManager.SaveViewState()

Per una descrizione di questo membro, vedere SaveViewState().

IStateManager.TrackViewState()

Per una descrizione di questo membro, vedere TrackViewState().

Si applica a

Vedi anche