Condividi tramite

ObjectDataSourceView Classe

Definizione

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

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:

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:

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:

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:

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 specificatekeys.
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 specificatikeys.
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 keysraccolte , valueso 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 DeletedObjectDataSourceView ha completato un'operazione di eliminazione.
OnDeleting(ObjectDataSourceMethodEventArgs)

Genera l'evento prima che l'oggetto DeletingObjectDataSourceView tenti un'operazione di eliminazione.
OnFiltering(ObjectDataSourceFilteringEventArgs)

Genera l'evento prima che l'oggetto FilteringObjectDataSourceView tenti un'operazione di filtro.
OnInserted(ObjectDataSourceStatusEventArgs)

Genera l'evento dopo che l'oggetto InsertedObjectDataSourceView ha completato un'operazione di inserimento.
OnInserting(ObjectDataSourceMethodEventArgs)

Genera l'evento prima che l'oggetto InsertingObjectDataSourceView 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 SelectedObjectDataSourceView ha completato un'operazione di recupero dati.
OnSelecting(ObjectDataSourceSelectingEventArgs)

Genera l'evento prima che l'oggetto SelectingObjectDataSourceView 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 UpdatingObjectDataSourceView 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 keysraccolte , valueso 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