Freigeben über


ObjectDataSourceView Klasse

Definition

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
ObjectDataSourceView
Implementiert

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 , UpdateDelete, 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 ObjectDataSourceViewObjectDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

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:

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 GridViewDetailsView, ü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:

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 GridViewDetailsView, ü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:

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)

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.

Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Führt einen asynchronen Löschvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(Geerbt von DataSourceView)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExecuteCommand(String, IDictionary, IDictionary)

Führt den angegebenen Befehl aus.

(Geerbt von DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

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)

Führt mithilfe der angegebenen values-Auflistung einen Einfügevorgang durch Aufrufen der Geschäftsobjektmethode aus, die von der InsertMethod-Eigenschaft angegeben wird.

Insert(IDictionary, DataSourceViewOperationCallback)

Führt einen asynchronen Einfügevorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(Geerbt von DataSourceView)
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)

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.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Ruft asynchron eine Liste der Daten aus dem zugrunde liegenden Datenspeicher ab.

(Geerbt von DataSourceView)
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)

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.

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Führt einen asynchronen Aktualisierungsvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(Geerbt von DataSourceView)

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:

Weitere Informationen