HierarchicalDataBoundControl Sınıf

Tanım

Verilerini hiyerarşik biçimde görüntüleyen tüm ASP.NET sürüm 2.0 veriye bağlı denetimler için temel sınıf görevi görür.

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
Devralma
HierarchicalDataBoundControl
Türetilmiş

Örnekler

Aşağıdaki kod örneği, özel bir veriye bağlı denetim oluşturmak için sınıfından HierarchicalDataBoundControl bir sınıfın nasıl türetilmiş olduğunu gösterir. Denetim, GeneologyTree ilişkili bir pre veri kaynağı denetiminden alınan veriler için metin ağacı içeren bir HTML bölümü işler.

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

Aşağıdaki kod örneği, önceki örnekte tanımlanan denetimin GeneologyTree nasıl kullanılacağını ve bir XmlDataSource denetime nasıl bağlanacağını gösterir.

<%@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>

Kod örneğinde erişilen geneology.xml dosyası aşağıdaki verileri içerir.

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

Açıklamalar

HierarchicalDataBoundControl sınıfı, ASP.NET hiyerarşik veri kaynağı denetiminden veri alan ve denetimin kullanıcı arabirimi öğelerini görüntülemek üzere bu verilere bağlayan ASP.NET denetimleri için kullanılan temel sınıftır. TreeView ve Menu sınıfları' ndan HierarchicalDataBoundControltüretilir.

Sayfa geliştiricileri sınıfı doğrudan kullanmaz HierarchicalDataBoundControl ; bunun yerine bu sınıftan türetilen denetimleri kullanır.

Denetim geliştiricileri bu sınıfı genişleterek ve HierarchicalDataSourceView sınıflarından HierarchicalDataSourceControl türetilen arabirimi ve sınıfları uygulayan IHierarchicalDataSource sınıflarla çalışan veriye bağlı denetimler oluşturur. sınıfından HierarchicalDataBoundControl bir sınıf türerken, denetiminizin kullanıcı arabirimi öğelerini yöntemi tarafından GetData alınan verilere bağlamak için yöntemini geçersiz kılınPerformDataBinding. Çoğu durumda yöntemi, PerformDataBinding türetilmiş sınıfınızda geçersiz kılacağınız tek yöntemdir.

ASP.NET 2.0 veriye bağlı denetimler PerformSelect için yöntemi yöntemin DataBind eşdeğeridir ve çalışma zamanında verileri bağlamak için çağrılır. PerformSelect yöntemi ve PerformDataBinding yöntemlerini çağırırGetData.

Oluşturucular

HierarchicalDataBoundControl()

HierarchicalDataBoundControl sınıfının yeni bir örneğini başlatır.

Özellikler

AccessKey

Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar.

(Devralındığı yer: WebControl)
Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
Attributes

Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır.

(Devralındığı yer: WebControl)
BackColor

Web sunucusu denetiminin arka plan rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
BorderColor

Web denetiminin kenarlık rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderStyle

Web sunucusu denetiminin kenarlık stilini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderWidth

Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.

(Devralındığı yer: Control)
ClientIDMode

özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.

(Devralındığı yer: Control)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
Controls

Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır.

(Devralındığı yer: Control)
ControlStyle

Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ControlStyleCreated

Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CssClass

İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar.

(Devralındığı yer: WebControl)
DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataSource

Veriye bağlı denetimin veri öğeleri listesini aldığı nesneyi alır veya ayarlar.

(Devralındığı yer: BaseDataBoundControl)
DataSourceID

Veriye bağlı denetimin veri öğeleri listesini aldığı denetimin kimliğini alır veya ayarlar.

DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Enabled

Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableTheming

Temaların bu denetime uygulanıp uygulanmayacağını belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableViewState

Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip taşımadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
Font

Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır.

(Devralındığı yer: WebControl)
ForeColor

Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar.

(Devralındığı yer: WebControl)
HasAttributes

Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır.

(Devralındığı yer: WebControl)
HasChildViewState

Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Height

Web sunucusu denetiminin yüksekliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ID

Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
Initialized

Veriye bağlı denetimin başlatılıp başlatılmadığını belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
IsBoundUsingDataSourceID

Özelliğin ayarlanıp ayarlanmadığını DataSourceID belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsDataBindingAutomatic

Veri bağlamanın otomatik olup olmadığını belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
IsEnabled

Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: WebControl)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Control)
IsUsingModelBinders

Türetilmiş bir sınıfta uygulandığında, denetimin model bağlayıcıları kullanıp kullanmadığını belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır.

(Devralındığı yer: Control)
Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
RequiresDataBinding

Yöntemin DataBind() çağrılıp çağrılmayacağını belirten bir değer alır veya ayarlar.

(Devralındığı yer: BaseDataBoundControl)
Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak kaplamayı alır veya ayarlar.

(Devralındığı yer: WebControl)
Style

Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır.

(Devralındığı yer: WebControl)
SupportsDisabledAttribute

Denetimin özelliği falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
TabIndex

Web sunucusu denetiminin sekme dizinini alır veya ayarlar.

(Devralındığı yer: WebControl)
TagKey

HtmlTextWriterTag Bu Web sunucusu denetimine karşılık gelen değeri alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TagName

Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
ToolTip

Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: WebControl)
UniqueID

Sunucu denetimi için benzersiz, hiyerarşik nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini gösteren bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ViewState

Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Width

Web sunucusu denetiminin genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)

Yöntemler

AddAttributesToRender(HtmlTextWriter)

Belirtilen HtmlTextWriterTagöğesine işlenmesi gereken HTML öznitelikleri ve stilleri ekler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.

(Devralındığı yer: Control)
ApplyStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: Control)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini başlatır.

(Devralındığı yer: Control)
BuildProfileTree(String, Boolean)

Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim Trace eder.

(Devralındığı yer: Control)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
ConfirmInitState()

Veriye bağlı denetimin başlatılmış durumunu ayarlar.

(Devralındığı yer: BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: Control)
CreateControlStyle()

Stille ilgili tüm özellikleri uygulamak için sınıf tarafından WebControl dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: BaseDataBoundControl)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
Dispose()

Sunucu denetiminin bellekten çıkmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureDataBound()

DataBind() özelliği ayarlanırsa ve veriye bağlı denetim bağlama gerektirecek şekilde işaretlenmişse DataSourceID yöntemini çağırır.

(Devralındığı yer: BaseDataBoundControl)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde pathOffset belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da aramaya yardımcı olur. Yönteminin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını denetime ayarlar.

(Devralındığı yer: Control)
GetData(String)

Veriye bağlı denetimin veri işlemlerini gerçekleştirmek için kullandığı bir HierarchicalDataSourceView nesneyi alır.

GetDataSource()

IHierarchicalDataSource Varsa, veriye bağlı denetimin ilişkilendirildiğini alır.

GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetRouteUrl(Object)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)

Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.

(Devralındığı yer: Control)
HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: Control)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini belirten bir değer döndürür.

(Devralındığı yer: Control)
IsLiteralContent()

Sunucu denetiminin yalnızca değişmez içeriği barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadViewState(Object)

yöntemiyle SaveViewState() kaydedilmiş önceki bir istekten görünüm durumu bilgilerini geri yükler.

(Devralındığı yer: WebControl)
MapPathSecure(String)

Mutlak veya göreli bir sanal yolun eşlendiğini fiziksel yolu alır.

(Devralındığı yer: Control)
MarkAsDataBound()

Görünüm durumundaki denetimin durumunu verilere başarıyla bağlı olarak ayarlar.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MergeStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın kullanıcı arabirimi sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnDataBound(EventArgs)

Olayı tetikler DataBound .

(Devralındığı yer: BaseDataBoundControl)
OnDataPropertyChanged()

Veriye bağlı denetimi verilerine yeniden bağlamak için temel veri kaynağı tanımlama özelliklerinden biri değiştirildiğinde çağrılır.

OnDataSourceChanged(Object, EventArgs)

Veriye bağlı denetimin çalıştığı örnek olayı tetiklediğinde IHierarchicalDataSource çağrılır DataSourceChanged .

OnInit(EventArgs)

Olayı işler Init .

(Devralındığı yer: BaseDataBoundControl)
OnLoad(EventArgs)

Olayı işler Load .

OnPagePreLoad(Object, EventArgs)

Denetim yüklenmeden önce veriye bağlı denetimin başlatılmış durumunu ayarlar.

OnPreRender(EventArgs)

Olayı işler PreRender .

(Devralındığı yer: BaseDataBoundControl)
OnUnload(EventArgs)

Olayı tetikler Unload .

(Devralındığı yer: Control)
OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
PerformDataBinding()

Türetilmiş bir sınıfta geçersiz kılındığında, veri kaynağındaki verileri denetime bağlar.

PerformSelect()

İlişkili veri kaynağından veri alır.

RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RemovedControl(Control)

Bir alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

Denetimi belirtilen HTML yazıcısına işler.

(Devralındığı yer: WebControl)
RenderBeginTag(HtmlTextWriter)

Denetimin HTML açma etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderContents(HtmlTextWriter)

Denetimin içeriğini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır.

(Devralındığı yer: Control)
RenderEndTag(HtmlTextWriter)

Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
SaveControlState()

Sayfa sunucuya geri gönderildiğinden bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SaveViewState()

Yöntemi çağrıldıktan sonra TrackViewState() değiştirilen tüm durumları kaydeder.

(Devralındığı yer: WebControl)
SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
SetTraceData(Object, Object)

İzleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
SetTraceData(Object, Object, Object)

İzlenen nesneyi, izleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Denetimin, nesnenin ViewState özelliğinde depolanabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur.

(Devralındığı yer: WebControl)
ValidateDataSource(Object)

Veriye bağlı denetimin bağlanabildiği nesnenin çalışabileceği nesne olduğunu doğrular.

Ekinlikler

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
DataBound

Sunucu denetimi bir veri kaynağına bağlandıktan sonra gerçekleşir.

(Devralındığı yer: BaseDataBoundControl)
Disposed

ASP.NET bir sayfa istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir. Bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IAttributeAccessor.GetAttribute(String)

Belirtilen ada sahip Web denetiminin özniteliğini alır.

(Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web denetiminin özniteliğini belirtilen ada ve değere ayarlar.

(Devralındığı yer: WebControl)
IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)

Uzantı Metotları

EnablePersistedSelection(BaseDataBoundControl)
Geçersiz.

Seçimi ve disk belleğini destekleyen veri denetimlerinde seçimin kalıcı olmasını sağlar.

FindDataSourceControl(Control)

Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.

FindFieldTemplate(Control, String)

Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.

FindMetaTable(Control)

İçeren veri denetimi için meta tablo nesnesini döndürür.

Şunlara uygulanır