Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

HierarchicalDataSourceControl-Klasse

 

Veröffentlicht: Oktober 2016

Stellt eine Basisklasse für Datenquellensteuerelemente bereit, die hierarchische Daten darstellen.

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

System.Object
  System.Web.UI.Control
    System.Web.UI.HierarchicalDataSourceControl
      System.Web.UI.WebControls.SiteMapDataSource
      System.Web.UI.WebControls.XmlDataSource

[BindableAttribute(false)]
public abstract class HierarchicalDataSourceControl : Control, 
	IHierarchicalDataSource

NameBeschreibung
System_CAPS_protmethodHierarchicalDataSourceControl()

Initialisiert eine neue Instanz der HierarchicalDataSourceControl-Klasse.

NameBeschreibung
System_CAPS_protpropertyAdapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Ruft ab oder legt das virtuelle Verzeichnis der Anwendung relativen des der Page oder UserControl -Objekt, das dieses Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyBindingContainer

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Steuerelement, das diesem Steuerelement Datenbindung enthält.(Geerbt von „Control“.)

System_CAPS_protpropertyChildControlsCreated

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.(Geerbt von „Control“.)

System_CAPS_pubpropertyClientID

Ruft den Serverbezeichner-Steuerelement von ASP.NET generiert wird.(Überschreibt Control.ClientID.)

System_CAPS_pubpropertyClientIDMode

Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet.(Überschreibt Control.ClientIDMode.)

System_CAPS_protpropertyClientIDSeparator

Ruft einen Zeichenwert, der verwendete Trennzeichen darstellt ab der ClientID Eigenschaft.(Geerbt von „Control“.)

System_CAPS_protpropertyContext

Ruft die HttpContext Objekt, das mit dem Steuerelement für die aktuelle Webanfrage zugeordnet.(Geerbt von „Control“.)

System_CAPS_pubpropertyControls

Ruft ein ControlCollection -Objekt, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.(Überschreibt Control.Controls.)

System_CAPS_pubpropertyDataItemContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataItemContainer.(Geerbt von „Control“.)

System_CAPS_pubpropertyDataKeysContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataKeysControl.(Geerbt von „Control“.)

System_CAPS_protpropertyDesignMode

Ruft einen Wert, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.(Geerbt von „Control“.)

System_CAPS_pubpropertyEnableTheming

Ruft einen Wert, der angibt, ob dieses Objekt Designs unterstützt.(Überschreibt Control.EnableTheming.)

System_CAPS_pubpropertyEnableViewState

Ruft 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.(Geerbt von „Control“.)

System_CAPS_protpropertyEvents

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.(Geerbt von „Control“.)

System_CAPS_protpropertyHasChildViewState

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des aktuellen Steuerelements gespeicherten Ansichtszustand Einstellungen verfügen.(Geerbt von „Control“.)

System_CAPS_pubpropertyID

Ruft ab oder legt den programmgesteuerten Bezeichner für das Webserversteuerelement zugewiesen.(Geerbt von „Control“.)

System_CAPS_protpropertyIdSeparator

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Zeichen zum Trennen der Steuerelement-IDs verwendet.(Geerbt von „Control“.)

System_CAPS_protpropertyIsChildControlStateCleared

Ruft einen Wert, der angibt, ob dieses Steuerelement enthaltenen Steuerelemente Steuerelementzustand verfügen.(Geerbt von „Control“.)

System_CAPS_protpropertyIsTrackingViewState

Ruft einen Wert, der angibt, ob das Serversteuerelement Änderungen an seinem Ansichtszustand gespeichert wird.(Geerbt von „Control“.)

System_CAPS_protpropertyIsViewStateEnabled

Ruft einen Wert, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.(Geerbt von „Control“.)

System_CAPS_protpropertyLoadViewStateByID

Ruft einen Wert, der angibt, ob das Steuerelement seinen Ansichtszustand über laden ID anstelle Index.(Geerbt von „Control“.)

System_CAPS_pubpropertyNamingContainer

Ruft ein Verweis auf das Serversteuerelement Benennungscontainers, erstellt einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben Control.ID Eigenschaftswert.(Geerbt von „Control“.)

System_CAPS_pubpropertyPage

Ruft einen Verweis auf die Page -Instanz, die das Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyParent

Ruft einen Verweis auf die übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyRenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der das gerenderte HTML kompatibel ist. (Geerbt von „Control“.)

System_CAPS_pubpropertySite

Ruft Informationen über den Container, der das aktuelle Steuerelement beim Rendern auf einer Entwurfsoberfläche hostet.(Geerbt von „Control“.)

System_CAPS_pubpropertySkinID

Ruft ab oder legt das Design zuweisen der HierarchicalDataSourceControl Steuerelement.(Überschreibt Control.SkinID.)

System_CAPS_pubpropertyTemplateControl

Ruft ab oder legt einen Verweis auf die Vorlage, die dieses Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyTemplateSourceDirectory

Ruft das virtuelle Verzeichnis von der Page oder UserControl die das aktuelle Steuerelement enthält.(Geerbt von „Control“.)

System_CAPS_pubpropertyUniqueID

Ruft den eindeutigen, hierarchisch qualifizierten Bezeichner für das Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubpropertyValidateRequestMode

Ruft ab oder legt einen Wert, der angibt, ob der Clienteingaben vom Browser auf potenziell gefährliche Werte überprüft.(Geerbt von „Control“.)

System_CAPS_protpropertyViewState

Ruft ein Wörterbuch von Statusinformationen, die zum Speichern und Wiederherstellen den Ansichtszustand eines Serversteuerelements in mehreren Anforderungen der gleichen Seite ermöglicht.(Geerbt von „Control“.)

System_CAPS_protpropertyViewStateIgnoresCase

Ruft einen Wert, der angibt, ob die StateBag Objekt wird Groß-/Kleinschreibung.(Geerbt von „Control“.)

System_CAPS_pubpropertyViewStateMode

Ruft ab oder legt den Modus Ansichtszustand des Steuerelements fest.(Geerbt von „Control“.)

System_CAPS_pubpropertyVisible

Ruft ab oder legt einen Wert, der angibt, ob das Steuerelement visuell angezeigt wird.(Überschreibt Control.Visible.)

NameBeschreibung
System_CAPS_protmethodAddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement hinzugefügt wird die Controls Auflistung von der Control Objekt.(Geerbt von „Control“.)

System_CAPS_protmethodAddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.(Geerbt von „Control“.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Wendet die Stileigenschaften, die im Stylesheet Seite auf das Steuerelement definiert sind.(Überschreibt Control.ApplyStyleSheetSkin(Page).)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Beginnt die Entwurfszeit-Verfolgung des Renderings von Daten.(Geerbt von „Control“.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Sammelt Informationen über das Steuerelement und übermittelt sie an die Trace -Eigenschaft angezeigt, wenn die Überwachung für die Seite aktiviert ist.(Geerbt von „Control“.)

System_CAPS_protmethodClearCachedClientID()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die zwischengespeicherte ClientID Wert null.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildState()

Löscht den Ansichtszustand und den Steuerelementzustand Informationen für alle des Serversteuerelements untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodClearChildViewState()

Löscht die Informationen zum Ansichtszustand für alle Serversteuerelemente untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die ClientIDMode -Eigenschaft der aktuellen Steuerelementinstanz und alle untergeordneten Steuerelemente entsprechend Inherit.(Geerbt von „Control“.)

System_CAPS_protmethodCreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.(Geerbt von „Control“.)

System_CAPS_protmethodCreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.(Überschreibt Control.CreateControlCollection().)

System_CAPS_pubmethodDataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodDataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option zum Auslösen der DataBinding Ereignis.(Geerbt von „Control“.)

System_CAPS_protmethodDataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.(Geerbt von „Control“.)

System_CAPS_pubmethodDispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor sie aus dem Speicher freigegeben wird.(Geerbt von „Control“.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Zur Entwurfszeit die Verfolgung von Renderingdaten wird beendet.(Geerbt von „Control“.)

System_CAPS_protmethodEnsureChildControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, erstellt er auf die untergeordneten Steuerelemente.(Geerbt von „Control“.)

System_CAPS_protmethodEnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.(Geerbt von „Control“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFindControl(String)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id Parameter.(Überschreibt Control.FindControl(String).)

System_CAPS_protmethodFindControl(String, Int32)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und eine ganze Zahl, die gemäß der pathOffset -Parameter, der die Suche unterstützt. Sie sollten diese Version von nicht überschreiben die FindControl Methode.(Geerbt von „Control“.)

System_CAPS_pubmethodFocus()

Setzt den Eingabefokus auf das Steuerelement.(Überschreibt Control.Focus().)

System_CAPS_protmethodGetDesignModeState()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft die Entwurfszeitdaten für ein Steuerelement ab.(Geerbt von „Control“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_protmethodGetHierarchicalView(String)

Ruft das Ansichtsobjekt-Hilfsprogramm für die IHierarchicalDataSource Schnittstelle für den angegebenen Pfad.

System_CAPS_pubmethodGetRouteUrl(Object)

Ruft die URL, die einen Satz von Routenparametern entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.(Geerbt von „Control“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Gibt den Präfixen Teil der UniqueID -Eigenschaft des angegebenen Steuerelements.(Geerbt von „Control“.)

System_CAPS_pubmethodHasControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.(Überschreibt Control.HasControls().)

System_CAPS_protmethodHasEvents()

Gibt einen Wert, der angibt, ob Ereignisse für das Steuerelement oder einem beliebigen untergeordneten Steuerelement registriert werden.(Geerbt von „Control“.)

System_CAPS_protmethodIsLiteralContent()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Bestimmt, ob das Serversteuerelement nur literalen Inhalt enthält.(Geerbt von „Control“.)

System_CAPS_protmethodLoadControlState(Object)

Steuerelementzustand Informationen aus einer früheren Seitenanforderung, die von gespeichert wurde wiederhergestellt die SaveControlState Methode.(Geerbt von „Control“.)

System_CAPS_protmethodLoadViewState(Object)

Stellt Ansichtszustandsinformationen aus einer früheren Seitenanforderung, die von gespeichert wurde die SaveViewState Methode.(Geerbt von „Control“.)

System_CAPS_protmethodMapPathSecure(String)

Ruft den physischen Pfad, dem ein virtueller Pfad, einen absoluten oder relativen zugeordnet ist.(Geerbt von „Control“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.(Geerbt von „Control“.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnDataSourceChanged(EventArgs)

Löst das DataSourceChanged-Ereignis aus.

System_CAPS_protmethodOnInit(EventArgs)

Löst das Init-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnLoad(EventArgs)

Löst das Load-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOnUnload(EventArgs)

Löst das Unload-Ereignis aus.(Geerbt von „Control“.)

System_CAPS_protmethodOpenFile(String)

Ruft eine Stream verwendet, um eine Datei zu lesen.(Geerbt von „Control“.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Weist eine beliebige Quelle des Ereignisses und den zugehörigen übergeordneten Element des Steuerelements.(Geerbt von „Control“.)

System_CAPS_protmethodRemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus entfernt, wird die Controls Auflistung von der Control Objekt.(Geerbt von „Control“.)

System_CAPS_protmethodRender(HtmlTextWriter)

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.(Geerbt von „Control“.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gibt den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter -Objekt, das den zu rendernden Inhalt auf dem Client schreibt.(Geerbt von „Control“.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.(Überschreibt Control.RenderControl(HtmlTextWriter).)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter -Objekt mithilfe eines bereitgestellten ControlAdapter Objekt.(Geerbt von „Control“.)

System_CAPS_protmethodResolveAdapter()

Ruft den Steuerelementadapter ab, für das Rendern des angegebenen Steuerelements verantwortlich.(Geerbt von „Control“.)

System_CAPS_pubmethodResolveClientUrl(String)

Ruft eine URL, die vom Browser verwendet werden kann.(Geerbt von „Control“.)

System_CAPS_pubmethodResolveUrl(String)

Konvertiert eine URL in eine, die auf dem anfordernden Client verwendet werden kann.(Geerbt von „Control“.)

System_CAPS_protmethodSaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.(Geerbt von „Control“.)

System_CAPS_protmethodSaveViewState()

Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.(Geerbt von „Control“.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.(Geerbt von „Control“.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Weist einen Ereignishandlerdelegaten für das Steuerelement und dessen Inhalt im übergeordneten Steuerelement zu rendern.(Geerbt von „Control“.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Daten unter Verwendung der Trace-Datenschlüssel und den Trace-Wert.(Geerbt von „Control“.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Renderingdaten, indem Sie das verfolgte Objekt der Trace-Datenschlüssel und den Trace-Wert.(Geerbt von „Control“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_protmethodTrackViewState()

Nachverfolgen von Änderungen am Ansichtszustand des Serversteuerelements verursacht, damit sie in des Serversteuerelements gespeichert werden können StateBag Objekt. Auf dieses Objekt kann über die Control.ViewState-Eigenschaft zugegriffen werden.(Geerbt von „Control“.)

NameBeschreibung
System_CAPS_pubeventDataBinding

Tritt auf, wenn das Steuerelement an eine Datenquelle bindet.(Geerbt von „Control“.)

System_CAPS_pubeventDisposed

Tritt auf, wenn ein Steuerelement aus dem Speicher freigegeben wird, die ist die letzte Phase des Lebenszyklus der ASP.NET-Seite angefordert wird.(Geerbt von „Control“.)

System_CAPS_pubeventInit

Tritt auf, wenn das Steuerelement initialisiert wird, ist der erste Schritt im Lebenszyklus.(Geerbt von „Control“.)

System_CAPS_pubeventLoad

Tritt auf, wenn das Steuerelement geladen wird die Page Objekt.(Geerbt von „Control“.)

System_CAPS_pubeventPreRender

Tritt ein, nachdem die Control Objekt ist geladen, jedoch vor dem Rendern.(Geerbt von „Control“.)

System_CAPS_pubeventUnload

Tritt auf, wenn das Steuerelement aus dem Speicher entladen wird.(Geerbt von „Control“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_priveventIHierarchicalDataSource.DataSourceChanged

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Tritt auf, wenn der HierarchicalDataSourceControl in irgendeiner Form, die von datengebundenen Steuerelementen wirkt sich geändert hat.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.GetDesignModeState.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetDesignModeState.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetOwnerControl.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIHierarchicalDataSource.GetHierarchicalView(String)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Ansichtsobjekt-Hilfsprogramm für die IHierarchicalDataSource Schnittstelle für den angegebenen Pfad.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter IParserAccessor.AddParsedSubObject.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter IControlBuilderAccessor.ControlBuilder.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.UserData.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.DataBindings.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.HasDataBindings.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.Expressions.(Geerbt von „Control“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.HasExpressions.(Geerbt von „Control“.)

NameBeschreibung
System_CAPS_pubmethodFindDataSourceControl()

Gibt die Datenquelle, die das Steuerelement für das angegebene Steuerelement zugeordnet ist.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Gibt die Feldvorlage für die angegebene Spalte in das angegebene Steuerelement Benennungscontainer zurück.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Gibt das Metatabelle für das enthaltende Datensteuerelement zurück.(Definiert durch DynamicDataExtensions.)

ASP.NET unterstützt eine Datenbindung, die Webserver-Steuerelemente an Daten binden und einheitlich darstellen können. Webserver-Steuerelemente, die an Daten gebunden werden als datengebundene Steuerelemente bezeichnet, und die Klassen, die die Bindung zu vereinfachen sind Datenquellensteuerelemente aufgerufen. Datenquellen-Steuerelemente können eine beliebige Datenquelle darstellen: eine Datei, einen Stream, eine relationale Datenbank, ein Geschäftsobjekt usw.. Datenquellensteuerelemente stellen Daten von datengebundenen Steuerelementen, unabhängig von der Quelle oder das Format der zugrunde liegenden Daten einheitlich.

Datenquellen-Steuerelemente, die hierarchische Daten darstellen, leiten Sie von der HierarchicalDataSourceControl -Klasse abgeleitet Datenquellen-Steuerelemente, die Listen oder Tabellen von Daten darstellen der DataSourceControl Klasse. Die HierarchicalDataSourceControl -Klasse ist die basisimplementierung der IHierarchicalDataSource -Schnittstelle, die eine einzige Methode zum Abrufen von hierarchischen Datenquellensicht-Objekte das Datenquellen-Steuerelement zugeordnete definiert, GetHierarchicalView.

Sozusagen ein Datenquellen-Steuerelement als Kombination aus dem HierarchicalDataSourceControl -Objekt und den zugehörigen Sichten für die zugrunde liegenden Daten, die Datenquellensicht-Objekte aufgerufen. Datenquellen-Steuerelemente, die tabellarische Daten darstellen, in der Regel nur eine benannte Ansicht zugeordnet sind die HierarchicalDataSourceControl -Klasse unterstützt eine Datenquellensicht für jede Ebene der hierarchischen Daten, die das Datenquellen-Steuerelement darstellt. Die Ebene der hierarchischen Daten wird durch einen eindeutigen hierarchischen Pfad, die an übergeben identifiziert die GetHierarchicalView -Methode in der viewPath Parameter. Jede HierarchicalDataSourceView -Objekt definiert die Funktionen eines Datenquellen-Steuerelements für die dargestellte hierarchische Ebene und führt Vorgänge wie z. B. Insert, Update, Delete und sortieren.

Webserver-Steuerelemente, die von abgeleitet sind die HierarchicalDataBoundControl Klasse, z. B. TreeView, verwenden Sie hierarchische Datenquellen-Steuerelemente, um hierarchische Daten binden.

Datenquellen-Steuerelemente werden als Steuerelemente deklarative Persistenz aktivieren und optional Teilnahme Verwaltung zulassen implementiert. Datenquellen-Steuerelemente werden nicht visuell gerendert und unterstützen deshalb keine Designs.

Im folgenden Codebeispiel wird veranschaulicht, wie der abstrakten erweitern HierarchicalDataSourceControl Klasse und die HierarchicalDataSourceView Klasse und Implementieren der IHierarchicalEnumerable und IHierarchyData Schnittstellen zum Erstellen einer hierarchischen Datenquellen-Steuerelement, die Systeminformationen abruft. Die FileSystemDataSource Steuerelement aktiviert Webserver-Steuerelemente zum Binden an FileSystemInfo -Objekte und grundlegende Dateisysteminformationen angezeigt. Die FileSystemDataSource -Klasse im Beispiel bietet die Implementierung von der GetHierarchicalView -Methode, die abruft ein FileSystemDataSourceView Objekt. Das FileSystemDataSourceView -Objekt ruft die Daten aus dem zugrunde liegenden Datenspeicher, in diesem Fall die Dateisysteminformationen auf dem Webserver ab. Systeminformationen aus Gründen der Sicherheit wird nur angezeigt, wenn das Datenquellen-Steuerelement in ein "localhost" verwendet wird, authentifiziert Szenario und startet nur mit dem virtuellen Verzeichnis, dem Web Forms-Seite mit dem Datenquellen-Steuerelement befindet. Schließlich zwei Klassen, implementieren IHierarchicalEnumerable und IHierarchyData dienen zum Umschließen der FileSystemInfo Objekte, FileSystemDataSource verwendet.

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 veranschaulicht, wie deklarativ binden ein TreeView Steuerelement, um Daten mithilfe der FileSystemDataSource Beispiel.

<%@ 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
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: