HierarchicalDataBoundControl Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Fungeert als basisklasse voor alle ASP.NET gegevensgebonden besturingselementen van versie 2.0 die hun gegevens in hiërarchische vorm weergeven.

public ref class HierarchicalDataBoundControl abstract : System::Web::UI::WebControls::BaseDataBoundControl

public abstract class HierarchicalDataBoundControl : System.Web.UI.WebControls.BaseDataBoundControl

type HierarchicalDataBoundControl = class
    inherit BaseDataBoundControl

Public MustInherit Class HierarchicalDataBoundControl
Inherits BaseDataBoundControl

Overname: Object

Control

WebControl

BaseDataBoundControl
HierarchicalDataBoundControl

Afgeleid: System.Web.UI.WebControls.Menu

System.Web.UI.WebControls.TreeView

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een klasse kunt afleiden uit de HierarchicalDataBoundControl klasse om een aangepast besturingselement voor gegevens te maken. Het GeneologyTree besturingselement geeft een pre HTML-sectie weer met een tekststructuur voor de gegevens die zijn opgehaald uit een gekoppeld besturingselement voor gegevensbronnen.

using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls {

    [AspNetHostingPermission(SecurityAction.Demand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    public class GeneologyTree : HierarchicalDataBoundControl {

        private TreeNode rootNode;
        public TreeNode RootNode {
            get {
                rootNode ??= new TreeNode(String.Empty);
                return rootNode;
            }
        }
        
        private ArrayList nodes;
        public ArrayList Nodes {
            get {
                if (null == nodes) {
                    nodes = new ArrayList();
                }
                return nodes;
            }
        }
        public string DataTextField {
            get {
                object o = ViewState["DataTextField"];
                return((o == null) ? string.Empty : (string)o);
            }
            set {
                ViewState["DataTextField"] = value;
                if (Initialized) {
                    OnDataPropertyChanged();
                }
            }
        }
        private int _maxDepth = 0;
        protected override void PerformDataBinding() {
            base.PerformDataBinding();

            // Do not attempt to bind data if there is no
            // data source set.
            if (!IsBoundUsingDataSourceID && (DataSource == null)) {
                return;
            }
            
            HierarchicalDataSourceView view = GetData(RootNode.DataPath);
            
            if (view == null) {
                throw new InvalidOperationException
                    ("No view returned by data source control.");
            }                                  
            
            IHierarchicalEnumerable enumerable = view.Select();
            if (enumerable != null) {
                            
                Nodes.Clear();
                                
                try {
                    RecurseDataBindInternal(RootNode, enumerable, 1);
                }
                finally {
                }
            }
        }
        private void RecurseDataBindInternal(TreeNode node, 
            IHierarchicalEnumerable enumerable, int depth) {                                    
                        
            foreach(object item in enumerable) {
                IHierarchyData data = enumerable.GetHierarchyData(item);

                if (null != data) {
                    // Create an object that represents the bound data
                    // to the control.
                    TreeNode newNode = new TreeNode();
                    RootViewNode rvnode = new RootViewNode();
                    
                    rvnode.Node = newNode;
                    rvnode.Depth = depth;

                    // The dataItem is not just a string, but potentially
                    // an XML node or some other container. 
                    // If DataTextField is set, use it to determine which 
                    // field to render. Otherwise, use the first field.                    
                    if (DataTextField.Length > 0) {
                        newNode.Text = DataBinder.GetPropertyValue
                            (data, DataTextField, null);
                    }
                    else {
                        PropertyDescriptorCollection props = 
                            TypeDescriptor.GetProperties(data);

                        // Set the "default" value of the node.
                        newNode.Text = String.Empty;                        

                        // Set the true data-bound value of the TextBox,
                        // if possible.
                        if (props.Count >= 1) {                        
                            if (null != props[0].GetValue(data)) {
                                newNode.Text = 
                                    props[0].GetValue(data).ToString();
                            } 
                        }
                    }

                    Nodes.Add(rvnode);                    
                    
                    if (data.HasChildren) {
                        IHierarchicalEnumerable newEnumerable = 
                            data.GetChildren();
                        if (newEnumerable != null) {                            
                            RecurseDataBindInternal(newNode, 
                                newEnumerable, depth+1 );
                        }
                    }
                    
                    if ( _maxDepth < depth) _maxDepth = depth;
                }
            }
        }
        protected override void Render(HtmlTextWriter writer) {
                        
            writer.WriteLine("<PRE>");                        
            int currentDepth = 1;
            int currentTextLen = 0;
            
            foreach (RootViewNode rvnode in Nodes) {
                if (rvnode.Depth == currentDepth) {
                    string output = "  " + rvnode.Node.Text + "  ";
                    writer.Write(output);
                    currentTextLen = currentTextLen + output.Length;
                }
                else {
                    writer.WriteLine("");
                    // Some very basic white-space formatting
                    int halfLine = currentTextLen / 2;
                    for (int i=0;i<halfLine;i++) {
                        writer.Write(' ');
                    }
                    writer.Write('|');
                    writer.WriteLine("");
                    ++currentDepth; 
                    currentTextLen = 0;
                    for (int j=0;j<halfLine;j++) {
                        writer.Write(' ');
                    }
                    string output = "  " + rvnode.Node.Text + "  ";
                    writer.Write(output);
                    currentTextLen = currentTextLen + output.Length;                    
                }                                                           
            }
            writer.WriteLine("</PRE>");
        }
        
        private class RootViewNode { 
            public TreeNode Node;
            public int Depth;
        }
    }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, _
      Level:=AspNetHostingPermissionLevel.Minimal), _
      AspNetHostingPermission(SecurityAction.InheritanceDemand, _
      Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class GeneologyTree
        Inherits HierarchicalDataBoundControl

        Dim MaxDepth As Integer = 0

        Private aRootNode As TreeNode
        Public ReadOnly Property RootNode() As TreeNode
            Get
                If aRootNode Is Nothing Then
                    aRootNode = New TreeNode(String.Empty)
                End If
                Return aRootNode
            End Get
        End Property

        Private alNodes As ArrayList
        Public ReadOnly Property Nodes() As ArrayList
            Get
                If alNodes Is Nothing Then
                    alNodes = New ArrayList()
                End If
                Return alNodes
            End Get
        End Property

        Public Property DataTextField() As String
            Get
                Dim o As Object = ViewState("DataTextField")
                If o Is Nothing Then
                    Return String.Empty
                Else
                    Return CStr(o)
                End If
            End Get
            Set(ByVal value As String)
                ViewState("DataTextField") = value
                If Initialized Then
                    OnDataPropertyChanged()
                End If
            End Set
        End Property

        Protected Overrides Sub PerformDataBinding()
            MyBase.PerformDataBinding()

            ' Do not attempt to bind data if there is no
            ' data source set.
            If Not IsBoundUsingDataSourceID AndAlso DataSource Is Nothing Then
                Return
            End If

            Dim view As HierarchicalDataSourceView = GetData(RootNode.DataPath)

            If view Is Nothing Then
                Throw New InvalidOperationException _
                ("No view returned by data source control.")
            End If

            Dim enumerable As IHierarchicalEnumerable = view.Select()
            If Not (enumerable Is Nothing) Then

                Nodes.Clear()

                Try
                    RecurseDataBindInternal(RootNode, enumerable, 1)
                Finally
                End Try
            End If

        End Sub

        Private Sub RecurseDataBindInternal(ByVal node As TreeNode, _
            ByVal enumerable As IHierarchicalEnumerable, _
            ByVal depth As Integer)

            Dim item As Object
            For Each item In enumerable

                Dim data As IHierarchyData = enumerable.GetHierarchyData(item)

                If Not data Is Nothing Then

                    ' Create an object that represents the bound data
                    ' to the control.
                    Dim newNode As New TreeNode()
                    Dim rvnode As New RootViewNode()

                    rvnode.Node = newNode
                    rvnode.Depth = depth

                    ' The dataItem is not just a string, but potentially
                    ' an XML node or some other container. 
                    ' If DataTextField is set, use it to determine which 
                    ' field to render. Otherwise, use the first field.                    
                    If DataTextField.Length > 0 Then
                        newNode.Text = DataBinder.GetPropertyValue _
                        (data, DataTextField, Nothing)
                    Else
                        Dim props As PropertyDescriptorCollection = _
                        TypeDescriptor.GetProperties(data)

                        ' Set the "default" value of the node.
                        newNode.Text = String.Empty

                        ' Set the true data-bound value of the TextBox,
                        ' if possible.
                        If props.Count >= 1 Then
                            If Not props(0).GetValue(data) Is Nothing Then
                                newNode.Text = props(0).GetValue(data).ToString()
                            End If
                        End If
                    End If

                    Nodes.Add(rvnode)

                    If data.HasChildren Then
                        Dim newEnumerable As IHierarchicalEnumerable = _
                            data.GetChildren()
                        If Not (newEnumerable Is Nothing) Then
                            RecurseDataBindInternal(newNode, _
                            newEnumerable, depth + 1)
                        End If
                    End If

                    If MaxDepth < depth Then
                        MaxDepth = depth
                    End If
                End If
            Next item

        End Sub

        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

            writer.WriteLine("<PRE>")
            Dim currentDepth As Integer = 1
            Dim currentTextLen As Integer = 0

            Dim rvnode As RootViewNode
            For Each rvnode In Nodes
                If rvnode.Depth = currentDepth Then
                    Dim output As String = "  " + rvnode.Node.Text + "  "
                    writer.Write(output)
                    currentTextLen = currentTextLen + output.Length
                Else
                    writer.WriteLine("")

                    ' Some very basic white-space formatting.
                    ' The implicit conversion to an Integer is fine, as 
                    ' a general estimate is acceptable for this 
                    ' simple example.
                    Dim halfLine As Integer = CInt(currentTextLen / 2)
                    Dim i As Integer
                    For i = 0 To halfLine
                        writer.Write(" "c)
                    Next i
                    writer.Write("|"c)
                    writer.WriteLine("")
                    currentDepth += 1
                    Dim j As Integer
                    For j = 0 To halfLine
                        writer.Write(" "c)
                    Next j
                    Dim output As String = "  " + rvnode.Node.Text + "  "
                    writer.Write(output)
                    currentTextLen = currentTextLen + output.Length
                End If
            Next rvnode
            writer.WriteLine("</PRE>")

        End Sub


        Private Class RootViewNode
            Public Node As TreeNode
            Public Depth As Integer
        End Class
    End Class
End Namespace

In het volgende codevoorbeeld ziet u hoe u het GeneologyTree besturingselement gebruikt dat in het vorige voorbeeld is gedefinieerd en hoe u dit koppelt aan een XmlDataSource besturingselement.

<%@Page language="c#" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" 
    Assembly="Samples.AspNet.CS.Controls" %>

<!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>
    <title>C# Example</title>
  </head>

  <body>
    <form id="Form1" method="post" runat="server">

        <aspSample:geneologytree
          id="GeneologyTree1"
          runat="server"
          datatextfield="title"
          datasourceid="XmlDataSource1" />

        <asp:xmldatasource
          id="XmlDataSource1"
          datafile="geneology.xml"          
          runat="server" />
          
    </form>
  </body>
</html>

<%@Page language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" 
    Assembly="Samples.AspNet.VB.Controls" %>

<!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>
    <title>VB Example</title>
  </head>

  <body>
    <form id="Form1" method="post" runat="server">

        <aspSample:geneologytree
          id="GeneologyTree1"
          runat="server"
          datatextfield="title"
          datasourceid="XmlDataSource1" />

        <asp:xmldatasource
          id="XmlDataSource1"
          datafile="geneology.xml"          
          runat="server" />
          
    </form>
  </body>
</html>

Het geneology.xml bestand dat in het codevoorbeeld wordt geopend, bevat de volgende gegevens.

<family>
  <member title="great-grandfather">
    <member title="grandfather" >
      <member title="child" />
      <member title="father" >
         <member title="son" />
      </member>
    </member>
  </member>
</family>

Opmerkingen

De klasse HierarchicalDataBoundControl is de basisklasse die wordt gebruikt voor ASP.NET besturingselementen waarmee gegevens worden opgehaald uit een ASP.NET hiërarchisch besturingselement voor gegevensbronnen en elementen van de gebruikersinterface van het besturingselement worden gekoppeld aan die gegevens om weer te geven. De TreeView en Menu klassen zijn afgeleid van HierarchicalDataBoundControl.

Paginaontwikkelaars gebruiken de HierarchicalDataBoundControl klasse niet rechtstreeks. In plaats daarvan gebruiken ze besturingselementen die zijn afgeleid van deze klasse.

Besturingselementen die ontwikkelaars gebruiken, breiden deze klasse uit om gegevensgebonden besturingselementen te maken die werken met klassen die de IHierarchicalDataSource interface en klassen implementeren die zijn afgeleid van de HierarchicalDataSourceControl en HierarchicalDataSourceView klassen. Bij het afleiden van een klasse van de HierarchicalDataBoundControl klasse overschrijft u de PerformDataBinding methode om de elementen van de gebruikersinterface van uw besturingselement te binden aan gegevens die door de GetData methode zijn opgehaald. In de meeste gevallen is de PerformDataBinding methode de enige methode die u in uw afgeleide klasse overschrijft.

Voor ASP.NET 2.0-gegevensgebonden besturingselementen is de methode PerformSelect het equivalent van de methode DataBind en wordt aangeroepen om gegevens tijdens runtime te binden. Met de PerformSelect methode worden de GetData en PerformDataBinding methoden aangeroepen.

Constructors

Name	Description
HierarchicalDataBoundControl()	Initialiseert een nieuw exemplaar van de HierarchicalDataBoundControl klasse.

Eigenschappen

Name	Description
AccessKey	Hiermee haalt u de toegangssleutel op waarmee u snel naar het webserverbeheer kunt navigeren. (Overgenomen van WebControl)
Adapter	Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control)
AppRelativeTemplateSourceDirectory	Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control)
Attributes	Hiermee haalt u de verzameling willekeurige kenmerken (alleen voor rendering) op die niet overeenkomen met eigenschappen in het besturingselement. (Overgenomen van WebControl)
BackColor	Hiermee haalt u de achtergrondkleur van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BindingContainer	Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control)
BorderColor	Hiermee haalt u de randkleur van het web besturingselement op of stelt u deze in. (Overgenomen van WebControl)
BorderStyle	Hiermee haalt u de randstijl van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BorderWidth	Hiermee haalt u de randbreedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
ChildControlsCreated	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control)
ClientID	Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET. (Overgenomen van Control)
ClientIDMode	Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren. (Overgenomen van Control)
ClientIDSeparator	Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control)
Context	Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control)
Controls	Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van Control)
ControlStyle	Hiermee haalt u de stijl van het besturingselement webserver op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ControlStyleCreated	Hiermee wordt een waarde opgehaald die aangeeft of er een Style object is gemaakt voor de ControlStyle eigenschap. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
CssClass	Hiermee wordt de CSS-klasse (Cascading Style Sheet) opgehaald of ingesteld die wordt weergegeven door het webserverbeheer op de client. (Overgenomen van WebControl)
DataItemContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control)
DataKeysContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control)
DataSource	Hiermee haalt u het object op waaruit het gegevensgebonden besturingselement de lijst met gegevensitems ophaalt. (Overgenomen van BaseDataBoundControl)
DataSourceID	Hiermee haalt u de id op van het besturingselement waaruit het gegevensgebonden besturingselement de lijst met gegevensitems ophaalt.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control)
Enabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement webserver is ingeschakeld. (Overgenomen van WebControl)
EnableTheming	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement. (Overgenomen van WebControl)
EnableViewState	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control)
Events	Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control)
Font	Hiermee haalt u de lettertype-eigenschappen op die zijn gekoppeld aan het besturingselement webserver. (Overgenomen van WebControl)
ForeColor	Hiermee haalt u de voorgrondkleur (meestal de kleur van de tekst) van het webserverbesturingselement op of stelt u deze in. (Overgenomen van WebControl)
HasAttributes	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement kenmerken heeft ingesteld. (Overgenomen van WebControl)
HasChildViewState	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control)
Height	Hiermee haalt u de hoogte van het webserverbeheer op of stelt u deze in. (Overgenomen van WebControl)
ID	Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control)
IdSeparator	Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control)
Initialized	Hiermee wordt een waarde opgehaald die aangeeft of het gegevensgebonden besturingselement is geïnitialiseerd. (Overgenomen van BaseDataBoundControl)
IsBoundUsingDataSourceID	Hiermee wordt een waarde opgehaald die aangeeft of de DataSourceID eigenschap is ingesteld. (Overgenomen van BaseDataBoundControl)
IsChildControlStateCleared	Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control)
IsDataBindingAutomatic	Hiermee wordt een waarde opgehaald die aangeeft of gegevensbinding automatisch is. (Overgenomen van BaseDataBoundControl)
IsEnabled	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement is ingeschakeld. (Overgenomen van WebControl)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control)
IsUsingModelBinders	Wanneer het is geïmplementeerd in een afgeleide klasse, haalt u een waarde op die aangeeft of het besturingselement modelbindingen gebruikt. (Overgenomen van BaseDataBoundControl)
IsViewStateEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control)
LoadViewStateByID	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control)
NamingContainer	Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control)
Page	Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control)
Parent	Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control)
RenderingCompatibility	Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control)
RequiresDataBinding	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de DataBind() methode moet worden aangeroepen. (Overgenomen van BaseDataBoundControl)
Site	Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control)
SkinID	Hiermee wordt de huid op de controle toegepast of ingesteld. (Overgenomen van WebControl)
Style	Hiermee haalt u een verzameling tekstkenmerken op die worden weergegeven als een stijlkenmerk op de buitenste tag van het besturingselement webserver. (Overgenomen van WebControl)
SupportsDisabledAttribute	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het `disabled` kenmerk van het gerenderde HTML-element moet instellen op 'uitgeschakeld' wanneer de eigenschap van IsEnabled het besturingselement is `false`. (Overgenomen van BaseDataBoundControl)
TabIndex	Hiermee haalt u de tabindex van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
TagKey	Hiermee haalt u de HtmlTextWriterTag waarde op die overeenkomt met dit besturingselement van de webserver. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
TagName	Hiermee haalt u de naam van het besturingselementlabel op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
TemplateControl	Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control)
TemplateSourceDirectory	Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control)
ToolTip	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven wanneer de muisaanwijzer boven het besturingselement webserver beweegt. (Overgenomen van WebControl)
UniqueID	Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control)
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control)
ViewStateIgnoresCase	Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control)
ViewStateMode	Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een serverbesturing wordt weergegeven als gebruikersinterface op de pagina. (Overgenomen van Control)
Width	Hiermee haalt u de breedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)

Methoden

Name	Description
AddAttributesToRender(HtmlTextWriter)	Hiermee worden HTML-kenmerken en -stijlen toegevoegd die moeten worden weergegeven aan de opgegeven HtmlTextWriterTag. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
AddedControl(Control, Int32)	Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control)
AddParsedSubObject(Object)	Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control)
ApplyStyle(Style)	Kopieert eventuele niet-lege elementen van de opgegeven stijl naar het web besturingselement, en overschrijft eventuele bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ApplyStyleSheetSkin(Page)	De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van Control)
BeginRenderTracing(TextWriter, Object)	Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control)
BuildProfileTree(String, Boolean)	Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control)
ClearCachedClientID()	Hiermee stelt u de waarde in de cache in ClientID op `null`. (Overgenomen van Control)
ClearChildControlState()	Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildState()	Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildViewState()	Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearEffectiveClientIDMode()	Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control)
ConfirmInitState()	Hiermee stelt u de geïnitialiseerde status van het gegevensgebonden besturingselement in. (Overgenomen van BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Kopieert de eigenschappen die niet zijn ingekapseld door het Style object van het opgegeven webserverbesturingselement naar het webserverbesturingselement waaruit deze methode wordt aangeroepen. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
CreateChildControls()	Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control)
CreateControlCollection()	Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van Control)
CreateControlStyle()	Hiermee maakt u het stijlobject dat intern door de WebControl klasse wordt gebruikt om alle stijlgerelateerde eigenschappen te implementeren. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
DataBind()	Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van BaseDataBoundControl)
DataBind(Boolean)	Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control)
DataBindChildren()	Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
Dispose()	Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control)
EndRenderTracing(TextWriter, Object)	Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control)
EnsureChildControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control)
EnsureDataBound()	Roept de DataBind() methode aan als de DataSourceID eigenschap is ingesteld en het gegevensgebonden besturingselement is gemarkeerd om binding te vereisen. (Overgenomen van BaseDataBoundControl)
EnsureID()	Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindControl(String, Int32)	Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven `id` in de `pathOffset` parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven. (Overgenomen van Control)
FindControl(String)	Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven `id` parameter. (Overgenomen van Control)
Focus()	Hiermee stelt u de invoerfocus in op een besturingselement. (Overgenomen van Control)
GetData(String)	Hiermee haalt u een HierarchicalDataSourceView object op dat door het gegevensgebonden besturingselement wordt gebruikt om gegevensbewerkingen uit te voeren.
GetDataSource()	Hiermee haalt u het IHierarchicalDataSource besturingselement op waaraan het gegevensgebonden besturingselement is gekoppeld, indien van toepassing.
GetDesignModeState()	Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetRouteUrl(Object)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(String, Object)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUniqueIDRelativeTo(Control)	Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control)
HasControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van Control)
HasEvents()	Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control)
IsLiteralContent()	Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control)
LoadControlState(Object)	Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control)
LoadViewState(Object)	Hiermee herstelt u informatie over de weergavestatus van een vorige aanvraag die is opgeslagen met de SaveViewState() methode. (Overgenomen van WebControl)
MapPathSecure(String)	Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control)
MarkAsDataBound()	Hiermee stelt u de status van het besturingselement in de weergavestatus in als gekoppeld aan gegevens.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MergeStyle(Style)	Kopieert niet-lege elementen van de opgegeven stijl naar het webbesturing, maar overschrijft geen bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
OnBubbleEvent(Object, EventArgs)	Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control)
OnDataBinding(EventArgs)	Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control)
OnDataBound(EventArgs)	Hiermee wordt de DataBound gebeurtenis gegenereerd. (Overgenomen van BaseDataBoundControl)
OnDataPropertyChanged()	Wordt aangeroepen wanneer een van de id-eigenschappen van de basisgegevensbron wordt gewijzigd om het besturingselement dat aan de gegevens is gebonden, opnieuw te koppelen aan de gegevens.
OnDataSourceChanged(Object, EventArgs)	Aangeroepen wanneer het exemplaar waarmee het IHierarchicalDataSource gegevensgebonden besturingselement werkt, de DataSourceChanged gebeurtenis genereert.
OnInit(EventArgs)	Hiermee wordt de Init gebeurtenis verwerkt. (Overgenomen van BaseDataBoundControl)
OnLoad(EventArgs)	Hiermee wordt de Load gebeurtenis verwerkt.
OnPagePreLoad(Object, EventArgs)	Hiermee stelt u de geïnitialiseerde status van het gegevensgebonden besturingselement in voordat het besturingselement wordt geladen.
OnPreRender(EventArgs)	Hiermee wordt de PreRender gebeurtenis verwerkt. (Overgenomen van BaseDataBoundControl)
OnUnload(EventArgs)	Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control)
OpenFile(String)	Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control)
PerformDataBinding()	Wanneer deze wordt overschreven in een afgeleide klasse, worden gegevens van de gegevensbron gekoppeld aan het besturingselement.
PerformSelect()	Hiermee worden gegevens opgehaald uit de gekoppelde gegevensbron.
RaiseBubbleEvent(Object, EventArgs)	Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control)
RemovedControl(Control)	Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control)
Render(HtmlTextWriter)	Hiermee wordt het besturingselement weergegeven voor de opgegeven HTML-schrijver. (Overgenomen van WebControl)
RenderBeginTag(HtmlTextWriter)	Geeft de HTML-openingstag van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
RenderChildren(HtmlTextWriter)	Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderContents(HtmlTextWriter)	Geeft de inhoud van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control)
RenderControl(HtmlTextWriter)	Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van Control)
RenderEndTag(HtmlTextWriter)	Geeft de HTML-slottag van het besturingselement weer in de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ResolveAdapter()	Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control)
ResolveClientUrl(String)	Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control)
ResolveUrl(String)	Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control)
SaveControlState()	Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SaveViewState()	Hiermee wordt een status opgeslagen die is gewijzigd nadat de TrackViewState() methode is aangeroepen. (Overgenomen van WebControl)
SetDesignModeState(IDictionary)	Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control)
SetRenderMethodDelegate(RenderMethod)	Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control)
SetTraceData(Object, Object, Object)	Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
SetTraceData(Object, Object)	Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee zorgt u ervoor dat het besturingselement wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het object. (Overgenomen van WebControl)
ValidateDataSource(Object)	Controleert of het object een gegevensgebonden besturingselement verbindt met één object waarmee het kan werken.

gebeurtenis

Name	Description
DataBinding	Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control)
DataBound	Vindt plaats nadat het serverbeheer verbinding heeft gemaakt met een gegevensbron. (Overgenomen van BaseDataBoundControl)
Disposed	Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control)
Init	Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control)
Load	Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control)
PreRender	Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control)
Unload	Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control)

Expliciete interface-implementaties

Name	Description
IAttributeAccessor.GetAttribute(String)	Hiermee haalt u een kenmerk van het webbeheer op met de opgegeven naam. (Overgenomen van WebControl)
IAttributeAccessor.SetAttribute(String, String)	Hiermee stelt u een kenmerk van het webbeheer in op de opgegeven naam en waarde. (Overgenomen van WebControl)
IControlBuilderAccessor.ControlBuilder	Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()	Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control)
IControlDesignerAccessor.UserData	Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control)
IDataBindingsAccessor.DataBindings	Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings	Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control)
IExpressionsAccessor.Expressions	Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control)
IExpressionsAccessor.HasExpressions	Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control)
IParserAccessor.AddParsedSubObject(Object)	Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control)

Extensiemethoden

Name	Description
EnablePersistedSelection(BaseDataBoundControl)	Verouderd. Hiermee kunt u selectie behouden in gegevensbesturingselementen die ondersteuning bieden voor selectie en paging.
FindDataSourceControl(Control)	Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.
FindFieldTemplate(Control, String)	Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.
FindMetaTable(Control)	Retourneert het metatable-object voor het bevattende gegevensbeheer.

Van toepassing op

Feedback

Is deze pagina nuttig?