ObjectDataSourceView Classe

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object

DataSourceView
ObjectDataSourceView

Implementazioni: IStateManager

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 , , Update DeleteeInsert, 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:

Metodo Select
Proprietà SelectMethod
Proprietà SelectParameters
Evento Selecting
Evento Selected

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:

Metodo Update
Proprietà UpdateMethod
Proprietà UpdateParameters
Evento Updating
Evento Updated

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:

Metodo Insert
Proprietà InsertMethod
Proprietà InsertParameters
Evento Inserting
Evento Inserted

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:

Metodo Delete
Proprietà DeleteMethod
Proprietà DeleteParameters
Evento Deleting
Evento Deleted

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)	Esegue un'operazione di eliminazione chiamando il metodo dell'oggetto business identificato dalla proprietà DeleteMethod utilizzando gli insiemi `keys` e `oldValues` specificati.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di eliminazione asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExecuteCommand(String, IDictionary, IDictionary)	Esegue il comando specificato. (Ereditato da DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	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)	Esegue un'operazione di inserimento chiamando il metodo dell'oggetto business identificato dalla proprietà InsertMethod utilizzando l'insieme `values` specificato.
Insert(IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di inserimento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)
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)	Recupera dati dall'oggetto identificato dalla proprietà TypeName chiamando il metodo identificato dalla proprietà SelectMethod e passando i valori nell'insieme SelectParameters.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ottiene un elenco di dati dall'archivio dati sottostante in modo asincrono. (Ereditato da DataSourceView)
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)	Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e utilizzando tutti i parametri forniti negli insiemi `keys`, `values` o `oldValues`.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di aggiornamento asincrona sull'elenco di dati rappresentato dall'oggetto DataSourceView. (Ereditato da DataSourceView)

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