ObjectDataSourceView Klasse
Definition
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
- 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:
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 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:
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 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:
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 |
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 |
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 |
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 |
ExecuteInsert(IDictionary) |
Führt mithilfe der angegebenen |
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 |
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 |
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 |
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(). |