ObjectDataSourceView Classe

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 ObjectDataSource controllo e fornisce un'interfaccia per i controlli associati a dati per eseguire operazioni sui dati con oggetti dati e business.

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 deve essere usata principalmente dai controlli associati a dati e non come oggetto programmabile nel codice della tabella.

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

Viene creato un ObjectDataSourceView oggetto per ogni istanza della ObjectDataSource classe in fase di esecuzione. Le chiamate alle operazioni sui 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 usando la 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 di dati. L'oggetto di cui è stata creata un'istanza ObjectDataSourceViewnon viene memorizzato nella cache da . L'oggetto viene creato e eliminato definitivamente per ogni chiamata al metodo dati. Se il metodo è static (Shared in Visual Basic), un'istanza non viene creata 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 ObjectDataSourceView sono 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 usando il Select metodo , che recupera una IEnumerable raccolta di elementi di dati. I metodi, le proprietà e gli eventi di recupero dei dati seguenti vengono implementati dall'oggetto ObjectDataSourceView ed esposti direttamente dal controllo ObjectDataSource 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 di 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 controllo ObjectDataSource 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 di 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 controllo ObjectDataSource 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 di 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 visualizzazione 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 controllo ObjectDataSource agli sviluppatori di pagine e ad altri chiamanti:

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

Filtro e ordinamento dei 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 ordinando ObjectDataSource 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à è identica a quella di una DataView.Sort proprietà.

Monitoraggio dello stato di visualizzazione

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 ASP.NET State Management Overview .For more information, see ASP.NET State Management Overview.

Costruttori

Nome	Descrizione
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Inizializza una nuova istanza della classe ObjectDataSourceView.

Proprietà

Nome	Descrizione
CanDelete	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta l'operazione di eliminazione.
CanInsert	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta l'operazione di inserimento.
CanPage	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta il paging tra i dati recuperati.
CanRetrieveTotalRowCount	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta il recupero del numero totale di righe di dati, oltre al set di dati.
CanSort	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta una vista ordinata nell'origine dati sottostante.
CanUpdate	Ottiene un valore che indica se l'oggetto ObjectDataSourceView associato al controllo corrente ObjectDataSource supporta l'operazione di aggiornamento.
ConflictDetection	Ottiene o imposta un valore che determina il modo in cui il ObjectDataSource controllo esegue aggiornamenti ed elimina quando i dati in una riga nell'archivio dati sottostante cambiano durante il tempo dell'operazione.
ConvertNullToDBNull	Ottiene o imposta un valore che indica se Parameter i valori passati a un'operazione di aggiornamento, inserimento o eliminazione vengono convertiti automaticamente da `null` al Value valore .
DataObjectTypeName	Ottiene o imposta il nome di una classe utilizzata dal ObjectDataSource controllo per un parametro in un'operazione di dati. Il ObjectDataSource controllo usa la classe specificata anziché gli Parameter oggetti presenti nei vari insiemi di parametri.
DeleteMethod	Ottiene o imposta il nome del metodo o della funzione richiamato dall'oggetto ObjectDataSourceView per eliminare i dati.
DeleteParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dal DeleteMethod metodo .
EnablePaging	Ottiene o imposta un valore che indica se il controllo origine dati supporta il paging tramite il set di dati recuperati.
Events	Ottiene un elenco di delegati del gestore eventi per la vista origine dati. (Ereditato da DataSourceView)
FilterExpression	Ottiene o imposta un'espressione di filtro applicata quando viene chiamato il metodo dell'oggetto SelectMethod business identificato dalla proprietà .
FilterParameters	Ottiene una raccolta di parametri associati a qualsiasi segnaposto di parametro presente nella FilterExpression stringa.
InsertMethod	Ottiene o imposta il nome del metodo o della funzione richiamato dall'oggetto ObjectDataSourceView per inserire i dati.
InsertParameters	Ottiene l'insieme di parametri che contiene i parametri utilizzati dal InsertMethod metodo .
IsTrackingViewState	Ottiene un valore che indica se l'oggetto ObjectDataSourceView sta salvando le modifiche apportate allo stato di visualizzazione.
MaximumRowsParameterName	Ottiene o imposta il nome del parametro del metodo di recupero dati utilizzato per indicare il numero di record da recuperare per il supporto del paging dell'origine dati.
Name	Ottiene il nome della vista 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 `Delete` metodi o `Update` .
ParsingCulture	Ottiene un valore o imposta un valore che indica le informazioni sulle impostazioni cultura utilizzate durante la conversione dei 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 della funzione richiamato dal ObjectDataSourceView controllo per recuperare un conteggio delle righe.
SelectMethod	Ottiene o imposta il nome del metodo o della funzione richiamato dal ObjectDataSourceView controllo per recuperare i dati.
SelectParameters	Ottiene l'insieme di parametri contenente i parametri utilizzati dal SelectMethod metodo .
SortParameterName	Ottiene o imposta il nome del parametro del metodo di recupero dati utilizzato per specificare un'espressione di ordinamento per il supporto dell'ordinamento dell'origine dati.
StartRowIndexParameterName	Ottiene o imposta il nome del parametro del metodo di recupero dati utilizzato per indicare l'indice intero del primo record da recuperare dal set di risultati per il supporto del paging dell'origine dati.
TypeName	Ottiene o imposta il nome della classe rappresentata dal ObjectDataSource controllo.
UpdateMethod	Ottiene o imposta il nome del metodo o della funzione richiamato dall'oggetto ObjectDataSourceView per aggiornare i dati.
UpdateParameters	Ottiene l'insieme di parametri contenente i parametri utilizzati dal UpdateMethod metodo .

Metodi

Nome	Descrizione
CanExecute(String)	Determina se è possibile eseguire il comando specificato. (Ereditato da DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di eliminazione asincrona nell'elenco di dati rappresentato dall'oggetto DataSourceView . (Ereditato da DataSourceView)
Delete(IDictionary, IDictionary)	Esegue un'operazione di eliminazione chiamando il metodo dell'oggetto DeleteMethod business identificato dalla proprietà utilizzando le raccolte e `oldValues` specificate`keys`.
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 DeleteMethod metodo e la raccolta e `oldValues` specificati`keys`.
ExecuteInsert(IDictionary)	Esegue un'operazione di inserimento chiamando il metodo dell'oggetto InsertMethod business identificato dalla proprietà utilizzando l'insieme specificato `values` .
ExecuteSelect(DataSourceSelectArguments)	Recupera i dati dall'oggetto identificato dalla TypeName proprietà chiamando il metodo identificato dalla SelectMethod proprietà e passando eventuali valori nell'insieme SelectParameters .
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla UpdateMethod proprietà e utilizzando tutti i parametri forniti nelle `keys`raccolte , `values`o `oldValues` .
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di inserimento asincrona nell'elenco di dati rappresentato dall'oggetto DataSourceView . (Ereditato da DataSourceView)
Insert(IDictionary)	Esegue un'operazione di inserimento chiamando il metodo dell'oggetto InsertMethod business identificato dalla proprietà utilizzando l'insieme specificato `values` .
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvato in precedenza per la vista origine dati.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnDataSourceViewChanged(EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Genera l'evento dopo che l'oggetto Deleted ObjectDataSourceView ha completato un'operazione di eliminazione.
OnDeleting(ObjectDataSourceMethodEventArgs)	Genera l'evento prima che l'oggetto Deleting ObjectDataSourceView tenti un'operazione di eliminazione.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Genera l'evento prima che l'oggetto Filtering ObjectDataSourceView tenti un'operazione di filtro.
OnInserted(ObjectDataSourceStatusEventArgs)	Genera l'evento dopo che l'oggetto Inserted ObjectDataSourceView ha completato un'operazione di inserimento.
OnInserting(ObjectDataSourceMethodEventArgs)	Genera l'evento prima che l'oggetto Inserting ObjectDataSourceView tenti un'operazione di inserimento.
OnObjectCreated(ObjectDataSourceEventArgs)	Genera l'evento ObjectCreated dopo la ObjectDataSourceView creazione di un'istanza dell'oggetto identificato dalla TypeName proprietà .
OnObjectCreating(ObjectDataSourceEventArgs)	Genera l'evento prima che l'oggetto ObjectCreating crei un'istanza ObjectDataSourceView di un oggetto business per eseguire un'operazione sui dati.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Genera l'evento prima che l'oggetto ObjectDisposing elimini un tipo di cui è stata creata un'istanza ObjectDataSourceView .
OnSelected(ObjectDataSourceStatusEventArgs)	Genera l'evento dopo che l'oggetto Selected ObjectDataSourceView ha completato un'operazione di recupero dati.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Genera l'evento prima che l'oggetto Selecting ObjectDataSourceView tenti un'operazione di recupero dati.
OnUpdated(ObjectDataSourceStatusEventArgs)	Genera l'evento Updated dopo che l'oggetto ObjectDataSourceView ha completato un'operazione di aggiornamento.
OnUpdating(ObjectDataSourceMethodEventArgs)	Genera l'evento prima che l'oggetto Updating ObjectDataSourceView tenti un'operazione di aggiornamento.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Chiamato dal RaiseUnsupportedCapabilitiesError(DataSourceView) metodo per confrontare le funzionalità richieste per un'operazione ExecuteSelect(DataSourceSelectArguments) rispetto a quelle supportate dalla vista. (Ereditato da DataSourceView)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione per l'oggetto ObjectDataSourceView dal momento in cui la pagina è stata pubblicata nel server.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ottiene un elenco di dati in modo asincrono dall'archivio dati sottostante. (Ereditato da DataSourceView)
Select(DataSourceSelectArguments)	Recupera i dati dall'oggetto identificato dalla TypeName proprietà chiamando il metodo identificato dalla SelectMethod proprietà e passando eventuali valori nell'insieme SelectParameters .
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Fa in modo che l'oggetto ObjectDataSourceView possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che le modifiche possano essere archiviate nell'oggetto ViewState per il controllo e mantenute tra le richieste per la stessa pagina.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Esegue un'operazione di aggiornamento asincrona nell'elenco di dati rappresentato dall'oggetto DataSourceView . (Ereditato da DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla UpdateMethod proprietà e utilizzando tutti i parametri forniti nelle `keys`raccolte , `values`o `oldValues` .

Eventi

Nome	Descrizione
DataSourceViewChanged	Si verifica quando la vista origine dati è stata modificata. (Ereditato da DataSourceView)
Deleted	Si verifica quando un'operazione Delete è stata completata.
Deleting	Si verifica prima di un'operazione Delete .
Filtering	Si verifica prima di un'operazione di filtro.
Inserted	Si verifica quando un'operazione Insert è stata completata.
Inserting	Si verifica prima di un'operazione Insert .
ObjectCreated	Si verifica dopo che l'oggetto crea un'istanza ObjectDataSourceView del tipo identificato dalla TypeName proprietà .
ObjectCreating	Si verifica prima che l'oggetto crei un'istanza ObjectDataSourceView del tipo identificato dalla TypeName proprietà .
ObjectDisposing	Si verifica quando l'oggetto rimuove un'istanza ObjectDataSourceView di un oggetto creato.
Selected	Si verifica quando un'operazione di recupero dati è stata completata.
Selecting	Si verifica prima di un'operazione di recupero dei dati.
Updated	Si verifica quando un'operazione Update è stata completata.
Updating	Si verifica prima di un'operazione Update .

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
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

Commenti e suggerimenti

Questa pagina è stata utile?