(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

HierarchicalDataSourceControl-Klasse

Stellt eine Basisklasse für Datenquellen-Steuerelemente bereit, die hierarchische Daten darstellen.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

[BindableAttribute(false)]
public abstract class HierarchicalDataSourceControl : Control, 
	IHierarchicalDataSource
<asp:HierarchicalDataSourceControl />

Der HierarchicalDataSourceControl-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Geschützte MethodeHierarchicalDataSourceControlInitialisiert eine neue Instanz der HierarchicalDataSourceControl-Klasse.
Zum Seitenanfang

  NameBeschreibung
Geschützte EigenschaftAdapterRuft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
Öffentliche EigenschaftAppRelativeTemplateSourceDirectoryRuft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Von Control geerbt.)
Öffentliche EigenschaftBindingContainerInfrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
Geschützte EigenschaftChildControlsCreatedRuft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
Öffentliche EigenschaftClientIDRuft den von ASP.NET generierten Bezeichner des Serversteuerelements ab. (Überschreibt Control.ClientID.)
Öffentliche EigenschaftClientIDModeDiese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet. (Überschreibt Control.ClientIDMode.)
Geschützte EigenschaftClientIDSeparatorRuft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Von Control geerbt.)
Geschützte EigenschaftContextRuft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Von Control geerbt.)
Öffentliche EigenschaftControlsRuft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Überschreibt Control.Controls.)
Öffentliche EigenschaftDataItemContainerRuft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Von Control geerbt.)
Öffentliche EigenschaftDataKeysContainerRuft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Von Control geerbt.)
Geschützte EigenschaftDesignModeRuft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
Öffentliche EigenschaftEnableThemingRuft einen Wert ab, der angibt, ob Designs von diesem Objekt unterstützt werden. (Überschreibt Control.EnableTheming.)
Öffentliche EigenschaftEnableViewStateRuft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Von Control geerbt.)
Geschützte EigenschaftEventsRuft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
Geschützte EigenschaftHasChildViewStateRuft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Von Control geerbt.)
Öffentliche EigenschaftIDRuft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Von Control geerbt.)
Geschützte EigenschaftIdSeparatorInfrastruktur. Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Von Control geerbt.)
Geschützte EigenschaftIsChildControlStateClearedRuft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Von Control geerbt.)
Geschützte EigenschaftIsTrackingViewStateRuft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
Geschützte EigenschaftIsViewStateEnabledRuft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
Geschützte EigenschaftLoadViewStateByIDRuft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Von Control geerbt.)
Öffentliche EigenschaftNamingContainerRuft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert unterschieden werden kann. (Von Control geerbt.)
Öffentliche EigenschaftPageRuft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
Öffentliche EigenschaftParentRuft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
Öffentliche EigenschaftRenderingCompatibility Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der das gerenderte HTML kompatibel ist. (Von Control geerbt.)
Öffentliche EigenschaftSiteRuft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Von Control geerbt.)
Öffentliche EigenschaftSkinIDRuft die Skin ab, die auf das HierarchicalDataSourceControl-Steuerelement angewendet werden soll, oder legt diese fest. (Überschreibt Control.SkinID.)
Öffentliche EigenschaftTemplateControlRuft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Von Control geerbt.)
Öffentliche EigenschaftTemplateSourceDirectoryRuft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Von Control geerbt.)
Öffentliche EigenschaftUniqueIDRuft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
Öffentliche EigenschaftValidateRequestModeRuft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Von Control geerbt.)
Geschützte EigenschaftViewStateRuft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Von Control geerbt.)
Geschützte EigenschaftViewStateIgnoresCaseRuft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Von Control geerbt.)
Öffentliche EigenschaftViewStateModeRuft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Von Control geerbt.)
Öffentliche EigenschaftVisibleRuft einen Wert ab, der angibt, ob das Steuerelement visuell dargestellt wird, oder legt diesen fest. (Überschreibt Control.Visible.)
Zum Seitenanfang

  NameBeschreibung
Geschützte MethodeAddedControlWird aufgerufen, nachdem ein untergeordnetes Steuerelement der Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Von Control geerbt.)
Geschützte MethodeAddParsedSubObjectBenachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Von Control geerbt.)
Öffentliche MethodeApplyStyleSheetSkinÜbernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Überschreibt Control.ApplyStyleSheetSkin(Page).)
Geschützte MethodeBeginRenderTracingStartet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Von Control geerbt.)
Geschützte MethodeBuildProfileTreeInfrastruktur. Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Von Control geerbt.)
Geschützte MethodeClearCachedClientIDInfrastruktur. Legt den zwischengespeicherten ClientID-Wert auf null fest. (Von Control geerbt.)
Geschützte MethodeClearChildControlStateLöscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearChildStateLöscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearChildViewStateLöscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearEffectiveClientIDModeInfrastruktur. Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Von Control geerbt.)
Geschützte MethodeCreateChildControlsWird vom ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente mit kompositionsbasierter Implementierung zu benachrichtigen, dass alle enthaltenen untergeordneten Steuerelemente als Vorbereitung auf einen Postback oder ein Rendering erstellt werden sollen. (Von Control geerbt.)
Geschützte MethodeCreateControlCollectionErstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (literale und Serversteuerelemente) des Serversteuerelements aufnehmen soll. (Überschreibt Control.CreateControlCollection().)
Öffentliche MethodeDataBind()Bindet eine Datenquelle an das aufgerufene Serversteuerelement und an alle untergeordneten Steuerelemente. (Von Control geerbt.)
Geschützte MethodeDataBind(Boolean)Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
Geschützte MethodeDataBindChildrenBindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Öffentliche MethodeDisposeErmöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Von Control geerbt.)
Geschützte MethodeEndRenderTracingBeendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Von Control geerbt.)
Geschützte MethodeEnsureChildControlsStellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Von Control geerbt.)
Geschützte MethodeEnsureIDErstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeFindControl(String)Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter. (Überschreibt Control.FindControl(String).)
Geschützte MethodeFindControl(String, Int32)Infrastruktur. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Von Control geerbt.)
Öffentliche MethodeFocusSetzt den Eingabefokus auf das Steuerelement. (Überschreibt Control.Focus().)
Geschützte MethodeGetDesignModeStateInfrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Geschützte MethodeGetHierarchicalViewRuft das Sichthilfsobjekt für die IHierarchicalDataSource-Schnittstelle für den angegebenen Pfad ab.
Öffentliche MethodeGetRouteUrl(Object)Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(RouteValueDictionary)Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(String, Object)Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(String, RouteValueDictionary)Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeGetUniqueIDRelativeToGibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
Öffentliche MethodeHasControlsErmittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Überschreibt Control.HasControls().)
Geschützte MethodeHasEventsGibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Von Control geerbt.)
Geschützte MethodeIsLiteralContentInfrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
Geschützte MethodeLoadControlStateStellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte MethodeLoadViewStateStellt die Informationen zum Ansichtszustand aus einer früheren Seitenanforderung wieder her, die durch die SaveViewState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte MethodeMapPathSecureRuft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Von Control geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeOnBubbleEventBestimmt, ob das Ereignis für das Serversteuerelement in der Serversteuerelementhierarchie der Benutzeroberfläche der Seite nach oben weitergegeben wird. (Von Control geerbt.)
Geschützte MethodeOnDataBindingLöst das DataBinding-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOnDataSourceChangedLöst das DataSourceChanged-Ereignis aus.
Geschützte MethodeOnInitLöst das Init-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOnLoadLöst das Load-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOnPreRenderLöst das PreRender-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOnUnloadLöst das Unload-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOpenFileRuft einen Stream zum Lesen einer Datei ab. (Von Control geerbt.)
Geschützte MethodeRaiseBubbleEventWeist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Von Control geerbt.)
Geschützte MethodeRemovedControlWird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Von Control geerbt.)
Geschützte MethodeRenderSendet den Inhalt eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
Geschützte MethodeRenderChildrenGibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
Öffentliche MethodeRenderControl(HtmlTextWriter)Gibt den Inhalt des Serversteuerelements an ein angegebenes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Überschreibt Control.RenderControl(HtmlTextWriter).)
Geschützte MethodeRenderControl(HtmlTextWriter, ControlAdapter)Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten ControlAdapter-Objekts an ein bereitgestelltes HtmlTextWriter-Objekt aus. (Von Control geerbt.)
Geschützte MethodeResolveAdapterRuft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Von Control geerbt.)
Öffentliche MethodeResolveClientUrlRuft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
Öffentliche MethodeResolveUrlKonvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Von Control geerbt.)
Geschützte MethodeSaveControlStateSpeichert alle Änderungen am Zustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte MethodeSaveViewStateSpeichert alle Änderungen am Ansichtszustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte MethodeSetDesignModeStateLegt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
Öffentliche MethodeSetRenderMethodDelegateInfrastruktur. Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Von Control geerbt.)
Öffentliche MethodeSetTraceData(Object, Object)Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Von Control geerbt.)
Öffentliche MethodeSetTraceData(Object, Object, Object)Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Von Control geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte MethodeTrackViewStateVeranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die Control.ViewState-Eigenschaft zugegriffen werden. (Von Control geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliches EreignisDataBindingTritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Von Control geerbt.)
Öffentliches EreignisDisposedTritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Von Control geerbt.)
Öffentliches EreignisInitTritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
Öffentliches EreignisLoadTritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
Öffentliches EreignisPreRenderTritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Von Control geerbt.)
Öffentliches EreignisUnloadTritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Von Control geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche ErweiterungsmethodeFindDataSourceControlGibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeFindFieldTemplateGibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeFindMetaTableGibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate EigenschaftIControlBuilderAccessor.ControlBuilderEine Beschreibung dieses Members finden Sie unter IControlBuilderAccessor.ControlBuilder. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.GetDesignModeStateEine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.GetDesignModeState. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.SetDesignModeStateEine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.SetDesignModeState. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.SetOwnerControlInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.SetOwnerControl. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIControlDesignerAccessor.UserDataEine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.UserData. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIDataBindingsAccessor.DataBindingsEine Beschreibung dieses Members finden Sie unter IDataBindingsAccessor.DataBindings. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIDataBindingsAccessor.HasDataBindingsEine Beschreibung dieses Members finden Sie unter IDataBindingsAccessor.HasDataBindings. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIExpressionsAccessor.ExpressionsEine Beschreibung dieses Members finden Sie unter IExpressionsAccessor.Expressions. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIExpressionsAccessor.HasExpressionsEine Beschreibung dieses Members finden Sie unter IExpressionsAccessor.HasExpressions. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivates EreignisIHierarchicalDataSource.DataSourceChangedInfrastruktur. Tritt auf, wenn sich HierarchicalDataSourceControl so geändert hat, dass datengebundene Steuerelemente beeinflusst werden.
Explizite SchnittstellenimplementierungPrivate MethodeIHierarchicalDataSource.GetHierarchicalViewInfrastruktur. Ruft das Sichthilfsobjekt für die IHierarchicalDataSource-Schnittstelle für den angegebenen Pfad ab.
Explizite SchnittstellenimplementierungPrivate MethodeIParserAccessor.AddParsedSubObjectEine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)
Zum Seitenanfang

ASP.NET unterstützt eine Datenbindungsarchitektur für Steuerelemente, mit der Webserversteuerelemente Daten binden und einheitlich darstellen können. Webserversteuerelemente, die Daten binden, werden als datengebundene Steuerelemente bezeichnet. Die Klassen, die diese Bindung ermöglichen, werden als Datenquellen-Steuerelemente bezeichnet. Datenquellensteuerelemente können eine beliebige Datenquelle darstellen: eine Datei, einen Stream, eine relationale Datenbank, ein Geschäftsobjekt usw. Datenquellensteuerelemente stellen datengebundenen Steuerelementen die Daten, unabhängig von der zugrunde liegenden Quelle oder dem zugrunde liegenden Format, konsistent bereit.

Datenquellen-Steuerelemente, die hierarchische Daten darstellen, werden aus der HierarchicalDataSourceControl-Klasse abgeleitet; Datenquellen-Steuerelemente, die Listen oder Tabellen darstellen, werden dagegen aus der DataSourceControl-Klasse abgeleitet. Die HierarchicalDataSourceControl-Klasse ist die Basisimplementierung der IHierarchicalDataSource-Schnittstelle, mit der eine einzelne Methode zum Abrufen hierarchischer Datenquellen-Ansichtsobjekte definiert wird, die dem Datenquellen-Steuerelement zugeordnet sind (GetHierarchicalView).

Sie können sich ein Datenquellen-Steuerelement als Kombination des HierarchicalDataSourceControl-Objekts und der zugehörigen Ansichten der zugrunde liegenden Daten vorstellen, die als Datenquellen-Ansichtsobjekte bezeichnet werden. Während Datenquellen-Steuerelemente, die tabellarische Daten darstellen, i. d. .R. nur einer benannten Ansicht zugeordnet sind, unterstützt die HierarchicalDataSourceControl-Klasse eine Datenquellenansicht für alle Ebenen der vom Datenquellen-Steuerelement dargestellten hierarchischen Daten. Die Ebene hierarchischer Daten wird von einem eindeutigen hierarchischen Pfad identifiziert, der im viewPath-Parameter an die GetHierarchicalView-Methode übergeben wird. Jedes HierarchicalDataSourceView-Objekt definiert die Funktionen eines Datenquellen-Steuerelements für die dargestellte hierarchische Ebene und führt Vorgänge wie Einfügen, Aktualisieren, Löschen und Sortieren aus.

Webserversteuerelemente, die von der HierarchicalDataBoundControl-Klasse abgeleitet sind (z. B. TreeView), verwenden hierarchische Datenquellen-Steuerelemente zur Bindung hierarchischer Daten.

Datenquellen-Steuerelemente werden als Steuerelemente implementiert, um die deklarative Beibehaltung zu aktivieren und optional die Integration in die Zustandsverwaltung zuzulassen. Datenquellen-Steuerelemente werden nicht visuell gerendert und unterstützen deshalb keine Designs.

Im folgenden Codebeispiel wird die Erweiterung der abstrakten HierarchicalDataSourceControl-Klasse und der HierarchicalDataSourceView-Klasse dargestellt. Weiterhin wird die Implementierung der IHierarchicalEnumerable-Schnittstelle und der IHierarchyData-Schnittstelle zum Erstellen eines hierarchischen Datenquellen-Steuerelements veranschaulicht, das Dateisysteminformationen abruft. Mit dem FileSystemDataSource-Steuerelement können Webserversteuerelemente an FileSystemInfo-Objekte gebunden und grundlegende Dateisysteminformationen angezeigt werden. Im Beispiel wird von der FileSystemDataSource-Klasse die Implementierung der GetHierarchicalView-Methode bereitgestellt, die ein FileSystemDataSourceView-Objekt abruft. Mit dem FileSystemDataSourceView-Objekt werden die Daten aus dem zugrunde liegenden Datenspeicher abgerufen, in diesem Fall handelt es sich dabei um die Dateisysteminformationen auf dem Webserver. Aus Sicherheitsgründen werden die Dateisysteminformationen nur angezeigt, wenn das Datenquellen-Steuerelement in einem authentifizierten Localhost-Szenario verwendet wird; außerdem wird zunächst nur das virtuelle Verzeichnis angezeigt, in dem sich die Web Forms-Seite befindet, die das Datenquellen-Steuerelement verwendet. Schließlich werden zwei Klassen bereitgestellt, die IHierarchicalEnumerable und IHierarchyData implementieren, als Wrapper für die FileSystemInfo-Objekte, die von FileSystemDataSource verwendet werden.


using System;
using System.Collections;
using System.IO;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

public class FileSystemDataSource :
    HierarchicalDataSourceControl, IHierarchicalDataSource
{
    private FileSystemDataSourceView view = null;

    public FileSystemDataSource() : base() { }

    protected override HierarchicalDataSourceView
        GetHierarchicalView(string viewPath)
    {
        view = new FileSystemDataSourceView(viewPath);
        return view;
    }
}
public class FileSystemDataSourceView : HierarchicalDataSourceView
{
    private string _viewPath;

    public FileSystemDataSourceView(string viewPath)
    {
        HttpRequest currentRequest = HttpContext.Current.Request;
        if (viewPath == "")
        {
            _viewPath = currentRequest.MapPath(currentRequest.ApplicationPath);
        }
        else
        {
            _viewPath = Path.Combine(
                currentRequest.MapPath(currentRequest.ApplicationPath),
                viewPath);
        }
    }

    // Starting with the rootNode, recursively build a list of
    // FileSystemInfo nodes, create FileSystemHierarchyData
    // objects, add them all to the FileSystemHierarchicalEnumerable,
    // and return the list.
    public override IHierarchicalEnumerable Select()
    {
        HttpRequest currentRequest = HttpContext.Current.Request;

        // SECURITY: There are many security issues that can be raised
        // SECURITY: by exposing the file system structure of a Web server
        // SECURITY: to an anonymous user in a limited trust scenario such as
        // SECURITY: a Web page served on an intranet or the Internet.
        // SECURITY: For this reason, the FileSystemDataSource only
        // SECURITY: shows data when the HttpRequest is received
        // SECURITY: from a local Web server. In addition, the data source
        // SECURITY: does not display data to anonymous users.
        if (currentRequest.IsAuthenticated &&
            (currentRequest.UserHostAddress == "127.0.0.1" ||
             currentRequest.UserHostAddress == "::1"))
        {
            DirectoryInfo rootDirectory = new DirectoryInfo(_viewPath);
            if (!rootDirectory.Exists)
            {
                return null;
            }

            FileSystemHierarchicalEnumerable fshe =
                new FileSystemHierarchicalEnumerable();

            foreach (FileSystemInfo fsi
                in rootDirectory.GetFileSystemInfos())
            {
                fshe.Add(new FileSystemHierarchyData(fsi));
            }
            return fshe;
        }
        else
        {
            throw new NotSupportedException(
                "The FileSystemDataSource only " +
                "presents data in an authenticated, localhost context.");
        }
    }
}
// A collection of FileSystemHierarchyData objects
public class FileSystemHierarchicalEnumerable :
    ArrayList, IHierarchicalEnumerable
{
    public FileSystemHierarchicalEnumerable()
        : base()
    {
    }

    public IHierarchyData GetHierarchyData(object enumeratedItem)
    {
        return enumeratedItem as IHierarchyData;
    }
}

public class FileSystemHierarchyData : IHierarchyData
{
    private FileSystemInfo fileSystemObject = null;

    public FileSystemHierarchyData(FileSystemInfo obj)
    {
        fileSystemObject = obj;
    }

    public override string ToString()
    {
        return fileSystemObject.Name;
    }
    // IHierarchyData implementation.
    public bool HasChildren
    {
        get
        {
            if (typeof(DirectoryInfo) == fileSystemObject.GetType())
            {
                DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
                return (temp.GetFileSystemInfos().Length > 0);
            }
            else return false;
        }
    }
    // DirectoryInfo returns the OriginalPath, while FileInfo returns
    // a fully qualified path.
    public string Path
    {
        get
        {
            return fileSystemObject.ToString();
        }
    }
    public object Item
    {
        get
        {
            return fileSystemObject;
        }
    }
    public string Type
    {
        get
        {
            return "FileSystemData";
        }
    }
    public IHierarchicalEnumerable GetChildren()
    {
        FileSystemHierarchicalEnumerable children =
            new FileSystemHierarchicalEnumerable();

        if (typeof(DirectoryInfo) == fileSystemObject.GetType())
        {
            DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
            foreach (FileSystemInfo fsi in temp.GetFileSystemInfos())
            {
                children.Add(new FileSystemHierarchyData(fsi));
            }
        }
        return children;
    }

    public IHierarchyData GetParent()
    {
        FileSystemHierarchicalEnumerable parentContainer =
            new FileSystemHierarchicalEnumerable();

        if (typeof(DirectoryInfo) == fileSystemObject.GetType())
        {
            DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
            return new FileSystemHierarchyData(temp.Parent);
        }
        else if (typeof(FileInfo) == fileSystemObject.GetType())
        {
            FileInfo temp = (FileInfo)fileSystemObject;
            return new FileSystemHierarchyData(temp.Directory);
        }
        // If FileSystemObj is any other kind of FileSystemInfo, ignore it.
        return null;
    }
}


Im folgenden Codebeispiel wird anhand des FileSystemDataSource-Beispiels veranschaulicht, wie ein TreeView-Steuerelement deklarativ an die Dateisystemdaten gebunden wird.


<%@ Page Language="C#" %>
<%@ Register Tagprefix="aspSample" Namespace="Samples.AspNet" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:treeview
                id="TreeView1"
                runat="server"
                datasourceid="FileSystemDataSource1" />            

            <aspSample:filesystemdatasource
                id = "FileSystemDataSource1"
                runat = "server" />            

        </form>
    </body>
</html>


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft