ObjectDataSourceView Klasse

Referenz

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 SelectVorgänge , Update Delete, undInsert, sortieren, filtern und verwalten von Einstellungen, die im Ansichtszustand gehalten werden.

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 verarbeitet. Seitenentwickler greifen nicht direkt auf die Instanz der ObjectDataSourceView -Klasse zu. Steuerelemententwickler können benutzerdefinierte Datensteuerelemente erstellen, indem sie die ObjectDataSource Klassen und ObjectDataSourceView erweitern.

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

Wird ObjectDataSourceView vom ObjectDataSource Steuerelement nicht direkt für Seitenentwickler verfügbar gemacht. Stattdessen wird über ObjectDataSourcedas -Element auf die ObjectDataSourceView Eigenschaften und Methoden des zugegriffen. Beispielsweise wird die DeleteMethod of-Eigenschaft ObjectDataSourceView durch Festlegen der DeleteMethod -Eigenschaft von ObjectDataSourcefestgelegt.

Abrufen von Daten

Der einfachste Vorgang, den eine Datenquellensicht ausführt, ist der Datenabruf aus dem zugrunde liegenden Datenspeicher mithilfe der Select -Methode, die eine IEnumerable Sammlung von Datenelementen abruft. Die folgenden Methoden, Eigenschaften und Ereignisse zum Abrufen von Daten werden vom -Objekt implementiert und direkt von seinem ObjectDataSourceView 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 Datenupdates, indem eine Geschäfts- oder Datenobjektmethode aufgerufen wird, die durch die UpdateMethod -Eigenschaft identifiziert wird. Datengebundene Steuerelemente, die Automatisch Updates ausführen, z. B. die GridView Steuerelemente 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 UpdateParameters Auflistung gefunden werden.

Die folgenden Updatemethoden, Eigenschaften und Ereignisse werden von der ObjectDataSourceView implementiert und direkt vom zugehörigen ObjectDataSource Steuerelement für Seitenentwickler und andere Aufrufer 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 Einfügevorgänge automatisch ausführen, z. B. und GridView 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 der ObjectDataSourceView implementiert und direkt vom zugehörigen ObjectDataSource Steuerelement für Seitenentwickler und andere Aufrufer 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 durch die DeleteMethod -Eigenschaft identifiziert wird. Datengebundene Steuerelemente, die automatisch Löschvorgänge ausführen, z. B. und GridView 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 der ObjectDataSourceView implementiert und direkt vom zugehörigen ObjectDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

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

Filtern und Sortieren von Daten

Der Datenabruf ist leistungsfähiger, wenn Sie die Daten dynamisch filtern können. Die Filterung wird nur vom ObjectDataSource -Steuerelement unterstützt, wenn die Select -Methode ein - oder DataSet -DataTableObjekt zurückgibt. Sie können die FilterExpression Eigenschaften und FilterParameters verwenden, um dynamische Filterung auf den Datenabruf anzuwenden. Diese Eigenschaften werden vom ObjectDataSourceView -Objekt implementiert und direkt vom - ObjectDataSource Steuerelement für datengebundene Steuerelemente und andere Aufrufer verfügbar gemacht.

Sie können die Daten sortieren, die Sie mit dem ObjectDataSource abrufen, indem Sie die Daten nach dem Abrufen im Arbeitsspeicher sortieren. Die Sortierung wird nur vom ObjectDataSource -Steuerelement unterstützt, wenn die Select -Methode ein DataTable oder DataSetzurückgibt. Die CanSort -Eigenschaft gibt immer zurück true, da der ObjectDataSourceView nicht bestimmen kann, welcher Typ von der Select -Methode zurückgegeben wird, ohne die -Methode aufzurufen. Die SortExpression Eigenschaftensyntax ist identisch mit der für eine DataView.Sort Eigenschaft.

Status der Nachverfolgungsansicht

Implementiert ObjectDataSourceView die Schnittstelle und verwendet den IStateManager Ansichtszustand, um ihren Zustand über Seitenanforderungen hinweg nachzuverfolgen. Die Implementierung der LoadViewStateMethoden , SaveViewStateund TrackViewState wird bereitgestellt, um die Ansichtsstatusnachverfolgung für das Steuerelement zu aktivieren. Weitere Informationen finden Sie unter übersicht über ASP.NET Zustandsverwaltung.

Konstruktoren

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Initialisiert eine neue Instanz der ObjectDataSourceView-Klasse.

Eigenschaften

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 der 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 zum Datensatz) 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	Ruft einen Wert ab, der bestimmt, wie das ObjectDataSource-Steuerelement Aktualisierungs- und Löschvorgänge ausführt, wenn die Daten einer Zeile im zugrunde liegenden Datenspeicher während der Vorgangsausführung geändert werden, oder legt diesen Wert fest.
ConvertNullToDBNull	Ruft einen Wert ab, der angibt, ob die an einen Aktualisierungs-, Einfüge- oder Löschvorgang übergebenen Parameter-Werte automatisch von `null` in einen Value-Wert konvertiert werden, oder legt diesen fest.
DataObjectTypeName	Ruft den Namen einer Klasse ab, die das ObjectDataSource-Steuerelement als Parameter in einem Datenvorgang verwendet, oder legt diesen fest. Anstelle der ObjectDataSource-Objekte, die sich in verschiedenen Parameterauflistungen befinden, verwendet das Parameter-Steuerelement die angegebene Klasse.
DeleteMethod	Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Objekt zum Löschen von Daten aufgerufen wird, oder legt diesen fest.
DeleteParameters	Ruft die Parameterauflistung ab, die die von der DeleteMethod-Methode verwendeten Parameter enthält.
EnablePaging	Ruft einen Wert ab, der angibt, ob das Datenquellen-Steuerelement Paging für den von ihm abgerufenen Datensatz unterstützt, oder legt diesen fest.
Events	Ruft eine Liste von Ereignishandlerdelegaten für die Datenquellenansicht ab. (Geerbt von DataSourceView)
FilterExpression	Ruft einen Filterausdruck ab, der beim Aufruf der von der SelectMethod-Eigenschaft angegebenen Geschäftsobjektmethode angewendet wird, oder legt diesen fest.
FilterParameters	Ruft eine Auflistung von Parametern ab, die beliebigen Parameterplatzhaltern in der FilterExpression-Zeichenfolge zugeordnet sind.
InsertMethod	Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Objekt zum Einfügen von Daten aufgerufen wird, oder legt diesen fest.
InsertParameters	Ruft die Parameterauflistung ab, die die von der InsertMethod-Methode verwendeten Parameter enthält.
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das ObjectDataSourceView-Objekt Änderungen des Ansichtszustands speichert.
MaximumRowsParameterName	Ruft den Namen des Datenabruf-Methodenparameters ab, der die Anzahl der abzurufenden Datensätze für die Paging-Unterstützung der Datenquelle angibt, oder legt diesen fest.
Name	Ruft den Namen der Datenquellenansicht ab. (Geerbt von DataSourceView)
OldValuesParameterFormatString	Ruft eine Formatzeichenfolge ab, die auf die Namen der Parameter für ursprüngliche Werte angewendet wird, die an die `Delete`-Methode oder an die `Update`-Methode übergeben werden, oder legt diese fest.
ParsingCulture	Ruft einen Wert ab oder legt einen Wert fest, der angibt, welche Kulturinformationen verwendet werden, wenn Zeichenfolgenwerte in tatsächliche Eigenschaftentypen konvertiert werden, um ein Objekt des Typs zu erstellen, der von DataObjectTypeName angegeben wird.
SelectCountMethod	Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Steuerelement zum Abrufen der Zeilenanzahl aufgerufen wird, oder legt diesen fest.
SelectMethod	Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Steuerelement zum Abrufen von Daten aufgerufen wird, oder legt diesen fest.
SelectParameters	Ruft die Parameterauflistung ab, die die von der SelectMethod-Methode verwendeten Parameter enthält.
SortParameterName	Ruft den Namen des Datenabruf-Methodenparameters ab, mit dem ein Sortierausdruck für die Unterstützung der Datenquellensortierung angegeben wird, oder legt diesen fest.
StartRowIndexParameterName	Ruft den Namen des Datenabruf-Methodenparameters ab, der den Ganzzahlindex des ersten abzurufenden Datensatzes aus dem Resultset für die Datenquellen-Pagingunterstützung angibt, oder legt diesen fest.
TypeName	Ruft den Namen der Klasse ab, die vom ObjectDataSource-Steuerelement dargestellt wird, oder legt diesen fest.
UpdateMethod	Ruft den Namen der Methode oder der Funktion auf, die vom ObjectDataSourceView-Objekt zum Aktualisieren von Daten aufgerufen wird, oder legt diesen fest.
UpdateParameters	Ruft die Parameterauflistung ab, die die von der UpdateMethod-Methode verwendeten Parameter enthält.

Methoden

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 mithilfe der angegebenen `keys`-Auflistung und der angegebenen `oldValues`-Auflistung einen Löschvorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der DeleteMethod-Eigenschaft angegeben wird.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (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 mithilfe der DeleteMethod-Methode sowie der angegebenen `keys`-Auflistung und der angegebenen `oldValues`-Auflistung einen Löschvorgang aus.
ExecuteInsert(IDictionary)	Führt mithilfe der angegebenen `values`-Auflistung einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der InsertMethod-Eigenschaft angegeben wird.
ExecuteSelect(DataSourceSelectArguments)	Ruft Daten aus einem von der TypeName-Eigenschaft angegebenen Objekt durch Aufruf der von der SelectMethod-Eigenschaft angegebenen Methode ab und übergibt dabei alle Werte in der SelectParameters-Auflistung.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Führt einen Aktualisierungsvorgang durch den Aufruf der von der UpdateMethod-Eigenschaft angegebenen Methode und unter Verwendung aller in den Auflistungen `keys`, `values` und `oldValues` vorhandenen Parameter durch.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den 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 mithilfe der angegebenen `values`-Auflistung einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der InsertMethod-Eigenschaft angegeben wird.
LoadViewState(Object)	Stellt den vorher gespeicherten Ansichtszustand für die Datenquellenansicht wieder her.
MemberwiseClone()	Erstellt eine flache Kopie des 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 startet.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Löst das Filtering-Ereignis aus, bevor das ObjectDataSourceView-Objekt einen Filtervorgang startet.
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 startet.
OnObjectCreated(ObjectDataSourceEventArgs)	Löst das ObjectCreated-Ereignis aus, nachdem die ObjectDataSourceView eine Instanz des von der TypeName-Eigenschaft angegebenen Objekts erstellt hat.
OnObjectCreating(ObjectDataSourceEventArgs)	Löst das ObjectCreating-Ereignis aus, bevor das ObjectDataSourceView-Objekt eine Instanz eines Geschäftsobjekts zum Ausführen eines Datenvorgangs erstellt.
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 startet.
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 startet.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Durch die RaiseUnsupportedCapabilitiesError(DataSourceView)-Methode aufgerufen, um die für einen ExecuteSelect(DataSourceSelectArguments)-Vorgang erforderlichen Funktionen mit denen zu vergleichen, die die Ansicht unterstützt. (Geerbt von DataSourceView)
SaveViewState()	Speichert die Änderungen am Ansichtszustand für das ObjectDataSourceView-Objekt ab dem Zeitpunkt, zu dem die Seite an den Server zurückgesendet wurde.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ruft asynchron eine Liste der Daten aus dem zugrunde liegenden Datenspeicher ab. (Geerbt von DataSourceView)
Select(DataSourceSelectArguments)	Ruft Daten aus einem von der TypeName-Eigenschaft angegebenen Objekt durch Aufruf der von der SelectMethod-Eigenschaft angegebenen Methode ab und übergibt dabei alle Werte in der SelectParameters-Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt, dass das ObjectDataSourceView-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Aktualisierungsvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt. (Geerbt von DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Führt einen Aktualisierungsvorgang durch den Aufruf der von der UpdateMethod-Eigenschaft angegebenen Methode und unter Verwendung aller in den Auflistungen `keys`, `values` und `oldValues` vorhandenen Parameter durch.

Ereignisse

DataSourceViewChanged	Tritt ein, wenn sich die Datenquellenansicht geändert hat. (Geerbt von DataSourceView)
Deleted	Tritt ein, wenn ein Delete-Vorgang abgeschlossen wurde.
Deleting	Tritt vor einem Delete-Vorgang auf.
Filtering	Tritt vor einem Filtervorgang auf.
Inserted	Tritt ein, wenn ein Insert-Vorgang abgeschlossen wurde.
Inserting	Tritt vor einem Insert-Vorgang ein.
ObjectCreated	Tritt ein, nachdem das ObjectDataSourceView-Objekt eine Instanz des von der TypeName-Eigenschaft angegebenen Typs erstellt hat.
ObjectCreating	Tritt ein, bevor das ObjectDataSourceView-Objekt eine Instanz des von der TypeName-Eigenschaft angegebenen Typs erstellt.
ObjectDisposing	Tritt ein, wenn das ObjectDataSourceView-Objekt eine Instanz eines von ihm erstellten Objekts verwirft.
Selected	Tritt ein, wenn ein Datenabrufvorgang abgeschlossen wurde.
Selecting	Tritt vor einem Datenabrufvorgang ein.
Updated	Tritt ein, wenn ein Update-Vorgang abgeschlossen wurde.
Updating	Tritt vor einem Update-Vorgang ein.

Explizite Schnittstellenimplementierungen

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

Gilt für:

Freigeben über