ObjectDataSourceView Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Unterstützt das ObjectDataSource Steuerelement und stellt eine Schnittstelle für datengebundene Steuerelemente zum Ausführen von Datenvorgängen mit Geschäfts- und Datenobjekten bereit.

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

Vererbung: Object

DataSourceView
ObjectDataSourceView

Implementiert: IStateManager

Hinweise

Die ObjectDataSourceView Klasse soll in erster Linie von datengebundenen Steuerelementen und nicht als programmierbares Objekt im Seitencode verwendet werden.

Die ObjectDataSourceView Klasse implementiert die Datenfunktionalität für das ObjectDataSource Steuerelement, einschließlich der Select, Update, Deleteund Insert Vorgänge, Sortierung, Filterung und Verwaltung von Einstellungen, die im Ansichtszustand gespeichert sind.

Für jede Instanz der ObjectDataSource Klasse wird zur Laufzeit ein ObjectDataSourceView Objekt erstellt. Aufrufe von Datenvorgängen der Instanz der ObjectDataSource Klasse werden von der Instanz des ObjectDataSourceView Objekts behandelt. Seitenentwickler greifen nicht direkt auf die Instanz der ObjectDataSourceView Klasse zu. Steuerelemententwickler können benutzerdefinierte Datensteuerelemente erstellen, indem sie die ObjectDataSource Klassen ObjectDataSourceView erweitern.

Die ObjectDataSourceView Klasse führt Datenvorgänge durch Aufrufen von Methoden für Geschäfts- oder Datenobjekte mithilfe von Spiegelung aus. Zur Laufzeit erstellt das ObjectDataSource Steuerelement eine Instanz des Typs, der durch die TypeName Eigenschaft identifiziert wird, und ruft dann die entsprechende Methode für den Datenvorgang auf. Das instanziierte Objekt wird nicht im Arbeitsspeicher zwischengespeichert.ObjectDataSourceView Das Objekt wird für jeden Datenmethodenaufruf erstellt und zerstört. Wenn die Methode (Sharedin Visual Basic) lautet static , wird keine Instanz erstellt, die Datenvorgangsmethode wird jedoch weiterhin aufgerufen.

Dies ObjectDataSourceView ist nicht direkt für Seitenentwickler durch das ObjectDataSource Steuerelement verfügbar. Stattdessen werden über die ObjectDataSourceEigenschaften und Methoden der ObjectDataSourceView . Beispielsweise wird die DeleteMethod ObjectDataSourceView Eigenschaft festgelegt, indem die DeleteMethod Eigenschaft der ObjectDataSource.

Abrufen von Daten

Der einfachste Vorgang, den eine Datenquellenansicht ausführt, ist das Abrufen von Daten aus dem zugrunde liegenden Datenspeicher mithilfe der Select Methode, die eine IEnumerable Sammlung von Datenelementen abruft. Die folgenden Datenabrufmethoden, Eigenschaften und Ereignisse werden vom ObjectDataSourceView Objekt implementiert und direkt von seinem ObjectDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

Die Select -Methode
Die SelectMethod-Eigenschaft.
Die SelectParameters-Eigenschaft.
Das Selecting Ereignis
Das Selected Ereignis

Aktualisieren von Daten

Das ObjectDataSourceView Objekt unterstützt Datenaktualisierungen durch Aufrufen einer Geschäfts- oder Datenobjektmethode, die von der UpdateMethod Eigenschaft identifiziert wird. Datengebundene Steuerelemente, die automatisch Aktualisierungen ausführen, z. B. die GridView Steuerelemente DetailsView , übergeben ihre Parameter in einer IOrderedDictionary Schnittstelle an das ObjectDataSourceView Und das Ansichtsobjekt führt diese Parameter mit allen Parametern zusammen, die in der UpdateParameters Auflistung gefunden werden.

Die folgenden Updatemethoden, Eigenschaften und Ereignisse werden von seitenentwicklern ObjectDataSourceView und anderen Aufrufern direkt von ihrem ObjectDataSource Steuerelement implementiert und verfügbar gemacht:

Die Update -Methode
Die UpdateMethod-Eigenschaft.
Die UpdateParameters-Eigenschaft.
Das Updating Ereignis
Das Updated Ereignis

Einfügen von Daten

Das ObjectDataSourceView Objekt unterstützt das Einfügen neuer Datenzeilen durch Aufrufen einer Geschäfts- oder Datenobjektmethode, die durch die InsertMethod Eigenschaft identifiziert wird. Datengebundene Steuerelemente, die automatisch Einfügungen ausführen, z. B. das GridView und DetailsView, übergeben ihre Parameter in einer IOrderedDictionary Schnittstelle an das ObjectDataSourceView Und das Ansichtsobjekt führt diese Parameter mit allen Parametern zusammen, die in der InsertParameters Auflistung gefunden werden.

Die folgenden Einfügemethoden, Eigenschaften und Ereignisse werden von dem ObjectDataSourceView Steuerelement direkt für ObjectDataSource Seitenentwickler und andere Aufrufer implementiert und verfügbar gemacht:

Die Insert -Methode
Die InsertMethod-Eigenschaft.
Die InsertParameters-Eigenschaft.
Das Inserting Ereignis
Das Inserted Ereignis

Löschen von Daten

Das ObjectDataSourceView Objekt unterstützt das Löschen von Daten durch Aufrufen einer Geschäfts- oder Datenobjektmethode, die von der DeleteMethod Eigenschaft identifiziert wird. Datengebundene Steuerelemente, die automatisch Löschvorgänge ausführen, z. B. das GridView und DetailsView, übergeben ihre Parameter in einer IOrderedDictionary Schnittstelle an das ObjectDataSourceView Und das Ansichtsobjekt führt diese Parameter mit allen Parametern zusammen, die in der DeleteParameters Auflistung gefunden werden. Die folgenden Löschmethoden, Eigenschaften und Ereignisse werden von seitenentwicklern ObjectDataSourceView und anderen Aufrufern direkt durch das ObjectDataSource Steuerelement implementiert und verfügbar gemacht:

Die Delete -Methode
Die DeleteMethod-Eigenschaft.
Die DeleteParameters-Eigenschaft.
Das Deleting Ereignis
Das Deleted Ereignis

Filtern und Sortieren von Daten

Der Datenempfang ist leistungsstärker, wenn Sie die Daten dynamisch filtern können. Das Filtern wird nur vom ObjectDataSource Steuerelement unterstützt, wenn die Select Methode ein oder DataSet ein DataTable Objekt zurückgibt. Mit den FilterExpression Eigenschaften FilterParameters können Sie dynamische Filterung auf den Datenabruf anwenden. Diese Eigenschaften werden vom ObjectDataSourceView Objekt implementiert und direkt durch das ObjectDataSource Steuerelement für datengebundene Steuerelemente und andere Aufrufer verfügbar gemacht.

Sie können die von Ihnen abgerufenen ObjectDataSource Daten sortieren, indem Sie die Daten im Arbeitsspeicher nach dem Abrufen sortieren. Die Sortierung wird nur vom ObjectDataSource Steuerelement unterstützt, wenn die Select Methode eine oder DataSetmehrere DataTable Werte zurückgibt. Die CanSort Eigenschaft gibt immer zurück true, da der ObjectDataSourceView Von der Select Methode zurückgegebene Typ nicht bestimmt werden kann, ohne die Methode aufzurufen. Die SortExpression Eigenschaftssyntax ist identisch mit einer DataView.Sort Eigenschaft.

Status der Nachverfolgungsansicht

Die ObjectDataSourceView Schnittstelle implementiert und verwendet den IStateManager Ansichtszustand, um den Zustand über Seitenanforderungen hinweg nachzuverfolgen. Die Implementierung der LoadViewStateMethoden , SaveViewStateund TrackViewState die Methoden werden bereitgestellt, um die Nachverfolgung des Ansichtszustands für das Steuerelement zu ermöglichen. Weitere Informationen finden Sie unter ASP.NET Übersicht über die Zustandsverwaltung.

Konstruktoren

Name	Beschreibung
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Initialisiert eine neue Instanz der ObjectDataSourceView-Klasse.

Eigenschaften

Name	Beschreibung
CanDelete	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, den Löschvorgang unterstützt.
CanInsert	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, den Einfügevorgang unterstützt.
CanPage	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, das Paging durch die abgerufenen Daten unterstützt.
CanRetrieveTotalRowCount	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, das Abrufen der Gesamtanzahl der Datenzeilen zusätzlich zur Datenmenge unterstützt.
CanSort	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, eine sortierte Ansicht der zugrunde liegenden Datenquelle unterstützt.
CanUpdate	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt, das dem aktuellen ObjectDataSource Steuerelement zugeordnet ist, den Aktualisierungsvorgang unterstützt.
ConflictDetection	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, wie das ObjectDataSource Steuerelement Aktualisierungen ausführt und löscht, wenn Sich Daten in einer Zeile in der zugrunde liegenden Datenspeicherzeit während des Vorgangs ändern.
ConvertNullToDBNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Parameter Werte, die an einen Aktualisierungs-, Einfüge- oder Löschvorgang übergeben werden, automatisch in `null` den Value Wert konvertiert werden.
DataObjectTypeName	Dient zum Abrufen oder Festlegen des Namens einer Klasse, die das ObjectDataSource Steuerelement für einen Parameter in einem Datenvorgang verwendet. Das ObjectDataSource Steuerelement verwendet die angegebene Klasse anstelle der Parameter Objekte, die sich in den verschiedenen Parameterauflistungen befinden.
DeleteMethod	Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Objekt zum Löschen von Daten aufruft.
DeleteParameters	Ruft die Parameterauflistung ab, die die Parameter enthält, die von der DeleteMethod Methode verwendet werden.
EnablePaging	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Datenquellensteuerelement das Paging über die datenmenge unterstützt, die sie abruft.
Events	Ruft eine Liste der Ereignishandlerdelegat für die Datenquellenansicht ab. (Geerbt von DataSourceView)
FilterExpression	Dient zum Abrufen oder Festlegen eines Filterausdrucks, der angewendet wird, wenn die von der SelectMethod Eigenschaft identifizierte Geschäftsobjektmethode aufgerufen wird.
FilterParameters	Ruft eine Auflistung von Parametern ab, die allen Parameterplatzhaltern zugeordnet sind, die sich in der FilterExpression Zeichenfolge befinden.
InsertMethod	Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Objekt zum Einfügen von Daten aufruft.
InsertParameters	Ruft die Parameterauflistung ab, die die Parameter enthält, die von der InsertMethod Methode verwendet werden.
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView Objekt Änderungen am Ansichtszustand speichert.
MaximumRowsParameterName	Dient zum Abrufen oder Festlegen des Namens des Datenabrufmethodenparameters, der verwendet wird, um die Anzahl der Datensätze anzugeben, die für die Unterstützung der Datenquellen paging abgerufen werden sollen.
Name	Ruft den Namen der Datenquellenansicht ab. (Geerbt von DataSourceView)
OldValuesParameterFormatString	Dient zum Abrufen oder Festlegen einer Formatzeichenfolge, die auf die Namen der Parameter für originale Werte angewendet werden soll, die an die oder `Update` die `Delete` Methoden übergeben werden.
ParsingCulture	Dient zum Abrufen oder Festlegen eines Werts, der angibt, welche Kulturinformationen verwendet werden, wenn Zeichenfolgenwerte in tatsächliche Eigenschaftstypen konvertiert werden, um ein Objekt des typs zu erstellen, der durch DataObjectTypeName.
SelectCountMethod	Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Steuerelement aufruft, um eine Zeilenanzahl abzurufen.
SelectMethod	Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Steuerelement aufruft, um Daten abzurufen.
SelectParameters	Ruft die Parameterauflistung ab, die die Parameter enthält, die von der SelectMethod Methode verwendet werden.
SortParameterName	Dient zum Abrufen oder Festlegen des Namens des Datenabrufmethodenparameters, der zum Angeben eines Sortierausdrucks für die Unterstützung der Datenquellensortierung verwendet wird.
StartRowIndexParameterName	Dient zum Abrufen oder Festlegen des Namens des Datenabrufmethodenparameters, der verwendet wird, um den ganzzahligen Index des ersten Datensatzes anzugeben, der aus dem Resultset für die Unterstützung der Datenquellen paging abgerufen werden soll.
TypeName	Dient zum Abrufen oder Festlegen des Namens der Klasse, die das ObjectDataSource Steuerelement darstellt.
UpdateMethod	Dient zum Abrufen oder Festlegen des Namens der Methode oder Funktion, die das ObjectDataSourceView Objekt zum Aktualisieren von Daten aufruft.
UpdateParameters	Ruft die Parameterauflistung ab, die die Parameter enthält, die von der UpdateMethod Methode verwendet werden.

Methoden

Name	Beschreibung
CanExecute(String)	Bestimmt, ob der angegebene Befehl ausgeführt werden kann. (Geerbt von DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Löschvorgang in der Liste der Daten aus, die das DataSourceView Objekt darstellt. (Geerbt von DataSourceView)
Delete(IDictionary, IDictionary)	Führt einen Löschvorgang aus, indem die Von der Eigenschaft identifizierte Geschäftsobjektmethode mithilfe der DeleteMethod angegebenen `keys` Auflistungen `oldValues` aufgerufen wird.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt den angegebenen Befehl aus. (Geerbt von DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Führt den angegebenen Befehl aus. (Geerbt von DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Führt einen Löschvorgang mithilfe der DeleteMethod Methode und der angegebenen `keys` und `oldValues` Auflistung aus.
ExecuteInsert(IDictionary)	Führt einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der Eigenschaft mithilfe der InsertMethod angegebenen `values` Auflistung identifiziert wird.
ExecuteSelect(DataSourceSelectArguments)	Ruft Daten aus dem Objekt ab, das von der TypeName Eigenschaft identifiziert wird, indem die von der SelectMethod Eigenschaft identifizierte Methode aufgerufen und alle Werte in der SelectParameters Auflistung übergeben werden.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Führt einen Aktualisierungsvorgang aus, indem die Methode aufgerufen wird, die von der UpdateMethod Eigenschaft identifiziert wird und alle Parameter verwendet werden, die in den `keys`, `values`oder `oldValues` Auflistungen angegeben werden.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Einfügevorgang in der Liste der Daten aus, die das DataSourceView Objekt darstellt. (Geerbt von DataSourceView)
Insert(IDictionary)	Führt einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der Eigenschaft mithilfe der InsertMethod angegebenen `values` Auflistung identifiziert wird.
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand für die Datenquellenansicht wieder her.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDataSourceViewChanged(EventArgs)	Löst das DataSourceViewChanged-Ereignis aus. (Geerbt von DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Löst das Deleted Ereignis aus, nachdem das ObjectDataSourceView Objekt einen Löschvorgang abgeschlossen hat.
OnDeleting(ObjectDataSourceMethodEventArgs)	Löst das Deleting Ereignis aus, bevor das ObjectDataSourceView Objekt einen Löschvorgang versucht.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Löst das Filtering Ereignis aus, bevor das ObjectDataSourceView Objekt einen Filtervorgang versucht.
OnInserted(ObjectDataSourceStatusEventArgs)	Löst das Inserted Ereignis aus, nachdem das ObjectDataSourceView Objekt einen Einfügevorgang abgeschlossen hat.
OnInserting(ObjectDataSourceMethodEventArgs)	Löst das Inserting Ereignis aus, bevor das ObjectDataSourceView Objekt einen Einfügevorgang versucht.
OnObjectCreated(ObjectDataSourceEventArgs)	Löst das ObjectCreated Ereignis aus, nachdem die ObjectDataSourceView Eigenschaft eine Instanz des Objekts erstellt hat, das durch die TypeName Eigenschaft identifiziert wird.
OnObjectCreating(ObjectDataSourceEventArgs)	Löst das ObjectCreating Ereignis aus, bevor das ObjectDataSourceView Objekt eine Instanz eines Geschäftsobjekts erstellt, um einen Datenvorgang auszuführen.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Löst das ObjectDisposing Ereignis aus, bevor das ObjectDataSourceView Objekt einen instanziierten Typ verwirft.
OnSelected(ObjectDataSourceStatusEventArgs)	Löst das Selected Ereignis aus, nachdem das ObjectDataSourceView Objekt einen Datenabrufvorgang abgeschlossen hat.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Löst das Selecting Ereignis aus, bevor das ObjectDataSourceView Objekt einen Datenabrufvorgang versucht.
OnUpdated(ObjectDataSourceStatusEventArgs)	Löst das Updated Ereignis aus, nachdem das ObjectDataSourceView Objekt einen Aktualisierungsvorgang abgeschlossen hat.
OnUpdating(ObjectDataSourceMethodEventArgs)	Löst das Updating Ereignis aus, bevor das ObjectDataSourceView Objekt einen Aktualisierungsvorgang versucht.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Wird von der RaiseUnsupportedCapabilitiesError(DataSourceView) Methode aufgerufen, um die für einen ExecuteSelect(DataSourceSelectArguments) Vorgang angeforderten Funktionen mit denen zu vergleichen, die die Ansicht unterstützt. (Geerbt von DataSourceView)
SaveViewState()	Speichert die Änderungen am Ansichtszustand für das ObjectDataSourceView Objekt seit dem Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet wurde.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ruft eine Liste der Daten asynchron aus dem zugrunde liegenden Datenspeicher ab. (Geerbt von DataSourceView)
Select(DataSourceSelectArguments)	Ruft Daten aus dem Objekt ab, das von der TypeName Eigenschaft identifiziert wird, indem die von der SelectMethod Eigenschaft identifizierte Methode aufgerufen und alle Werte in der SelectParameters Auflistung übergeben werden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt, dass das ObjectDataSourceView Objekt Änderungen am Ansichtszustand nachverfolgt, sodass die Änderungen im ViewState Objekt für das Steuerelement gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Aktualisierungsvorgang für die Liste der Daten aus, die das DataSourceView Objekt darstellt. (Geerbt von DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Führt einen Aktualisierungsvorgang aus, indem die Methode aufgerufen wird, die von der UpdateMethod Eigenschaft identifiziert wird und alle Parameter verwendet werden, die in den `keys`, `values`oder `oldValues` Auflistungen angegeben werden.

Ereignisse

Name	Beschreibung
DataSourceViewChanged	Tritt auf, wenn sich die Datenquellenansicht geändert hat. (Geerbt von DataSourceView)
Deleted	Tritt auf, wenn ein Delete Vorgang abgeschlossen wurde.
Deleting	Tritt vor einem Vorgang auf Delete .
Filtering	Tritt vor einem Filtervorgang auf.
Inserted	Tritt auf, wenn ein Insert Vorgang abgeschlossen ist.
Inserting	Tritt vor einem Insert Vorgang auf.
ObjectCreated	Tritt ein, nachdem das ObjectDataSourceView Objekt eine Instanz des Typs erstellt hat, der durch die TypeName Eigenschaft identifiziert wird.
ObjectCreating	Tritt auf, bevor das ObjectDataSourceView Objekt eine Instanz des Typs erstellt, der durch die TypeName Eigenschaft identifiziert wird.
ObjectDisposing	Tritt auf, wenn das ObjectDataSourceView Objekt eine Instanz eines Objekts verwirft, das es erstellt hat.
Selected	Tritt auf, wenn ein Datenabrufvorgang abgeschlossen wurde.
Selecting	Tritt auf, bevor ein Datenempfangsvorgang ausgeführt wird.
Updated	Tritt auf, wenn ein Update Vorgang abgeschlossen ist.
Updating	Tritt vor einem Update Vorgang auf.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IStateManager.IsTrackingViewState	Eine Beschreibung dieses Mitglieds finden Sie unter IsTrackingViewState.
IStateManager.LoadViewState(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter LoadViewState(Object).
IStateManager.SaveViewState()	Eine Beschreibung dieses Mitglieds finden Sie unter SaveViewState().
IStateManager.TrackViewState()	Eine Beschreibung dieses Mitglieds finden Sie unter TrackViewState().

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?