ControlBuilder Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetim oluştururken sayfa ayrıştırıcısını ve içerdiği alt denetimleri destekler.

public ref class ControlBuilder

public class ControlBuilder

type ControlBuilder = class

Public Class ControlBuilder

Devralma: Object
ControlBuilder

Türetilmiş: System.Web.UI.CodeStatementBuilder

System.Web.UI.DataSourceControlBuilder

System.Web.UI.HtmlControls.HtmlEmptyTagControlBuilder

System.Web.UI.HtmlControls.HtmlHeadBuilder

System.Web.UI.HtmlControls.HtmlSelectBuilder

Diğer…

Örnekler

Aşağıdaki kod örneği, tablonun oluşturulduğu sırada öznitelikleri ve içeriği tanımlanan bir Table denetim oluşturur. Yürütülebilir dosyayı derlemek için kullanılacak komut satırı aşağıdadır.

vbc /r:System.dll /r:System.Web.dll /r:System.Drawing.dll /t:library /out:myWebAppPath/Bin/vb_mycontrolbuilder.dll myControlBuilder.vb

csc /t:library /out:myWebAppPath/Bin/cs_mycontrolbuilder.dll myControlBuilder.cs

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

namespace CustomControls
{
    [AspNetHostingPermission(SecurityAction.Demand,
        Level = AspNetHostingPermissionLevel.Minimal)]
    public class MyTableCell : TableCell, INamingContainer { };

    [AspNetHostingPermission(SecurityAction.Demand,
        Level = AspNetHostingPermissionLevel.Minimal)]
    public class MyCell
    /*
     * Class name: MyCell.
     * Declares the class for the child controls to include in the control collection.
     */
    {
        string _id;
        string _value;
        Color _backColor;

        public string CellID
        {
            get
            { return _id; }
            set
            { _id = value; }
        }

        public string Text
        {
            get
            { return _value; }
            set
            { _value = value; }
        }

        public Color BackColor
        {
            get
            { return _backColor; }
            set
            { _backColor = value; }
        }
    };

    [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
    public class MyControlBuilder : ControlBuilder
    {

        public override Type GetChildControlType(string tagName, IDictionary attribs)
        {
            // Allows TableRow without "runat=server" attribute to be added to the collection.
            if (String.Compare(tagName, "mycell", true) == 0)
                return typeof(MyCell);
            return null;
        }

        public override void AppendLiteralString(string s)
        {
            // Ignores literals between rows.
        }
    }
    [AspNetHostingPermission(SecurityAction.Demand,
        Level = AspNetHostingPermissionLevel.Minimal)]
    [ControlBuilderAttribute(typeof(MyControlBuilder))]
    public class MyCS_CustomControl : Control, INamingContainer
    /*
     * Class name: MyCS_CustomControl.
     * Processes the element declarations within a control declaration. 
     * This builds the actual control.
     */
    {
        // Declares the custom control that must be built programmatically.
        Table _table;

        private String _title;
        private int _rows;
        private int _columns;

        Hashtable _cellObjects = new Hashtable();

        // Rows property to be used as the attribute name in the Web page.  
        public int Rows
        {
            get
            { return _rows; }
            set
            { _rows = value; }
        }

        // Columns property to be used as the attribute name in the Web page.
        public int Columns
        {
            get
            { return _columns; }
            set
            { _columns = value; }
        }

        // Title property to be used as the attribute name in the Web page.
        public string Title
        {
            get
            { return _title; }
            set
            { _title = value; }
        }

        protected void createNewRow(int rowNumber)
        {

            // Creates a row and adds it to the table.
            TableRow row;

            row = new TableRow();
            _table.Rows.Add(row);

            // Creates a cell that contains text.

            for (int y = 0; y < Columns; y++)
                appendCell(row, rowNumber, y);
        }

        protected void appendCell(TableRow row, int rowNumber, int cellNumber)
        {
            TableCell cell;
            TextBox textbox;

            cell = new TableCell();
            textbox = new TextBox();
            cell.Controls.Add(textbox);
            textbox.ID = "r" + rowNumber.ToString() + "c" + cellNumber.ToString();

            // Checks for the MyCell child object.
            if (_cellObjects[textbox.ID] != null)
            {
                MyCell cellLookup;
                cellLookup = (MyCell)_cellObjects[textbox.ID];

                textbox.Text = cellLookup.Text;
                textbox.BackColor = cellLookup.BackColor;
            }
            else
                textbox.Text = "Row: " + rowNumber.ToString() + " Cell: " +
                cellNumber.ToString();

            row.Cells.Add(cell);
        }

        // Called at runtime when a child object is added to the collection.  
        protected override void AddParsedSubObject(object obj)
        {
            MyCell cell = obj as MyCell;
            if (cell != null)
            {
                _cellObjects.Add(cell.CellID, cell);
            }
        }

        protected override void OnPreRender(EventArgs e)
        /*
         * Function name: OnPreRender.
         * Carries out changes affecting the control state and renders the resulting UI.
        */
        {

            // Increases the number of rows if needed.
            while (_table.Rows.Count < Rows)
            {
                createNewRow(_table.Rows.Count);
            }

            // Checks that each row has the correct number of columns.
            for (int i = 0; i < _table.Rows.Count; i++)
            {
                while (_table.Rows[i].Cells.Count < Columns)
                {
                    appendCell(_table.Rows[i], i, _table.Rows[i].Cells.Count);
                }

                while (_table.Rows[i].Cells.Count > Columns)
                {
                    _table.Rows[i].Cells.RemoveAt(_table.Rows[i].Cells.Count - 1);
                }
            }
        }

        protected override void CreateChildControls()
        /*
         * Function name: CreateChildControls.
         * Adds the Table and the text control to the control collection.
         */
        {
            LiteralControl text;

            // Initializes the text control using the Title property.
            text = new LiteralControl("<h5>" + Title + "</h5>");
            Controls.Add(text);

            _table = new Table();
            _table.BorderWidth = 2;
            Controls.Add(_table);
        }
    }
}

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


Namespace CustomControls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class MyTableCell
        Inherits TableCell
        Implements INamingContainer
    End Class


    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class MyCell
        Inherits Control
        Implements INamingContainer
        ' Class Name: MyCell.
        ' Declares the class for the child controls to be included in the control collection.

        Private _id As String
        Private _value As String
        Private _backColor As Color

        Public Property CellID() As String
            Get
                Return _id
            End Get
            Set(ByVal value As String)
                _id = value
            End Set
        End Property

        Public Property Text() As String
            Get
                Return _value
            End Get
            Set(ByVal value As String)
                _value = value
            End Set
        End Property


        Public Property BackColor() As Color
            Get
                Return _backColor
            End Get
            Set(ByVal value As Color)
                _backColor = value
            End Set
        End Property
    End Class

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class MyControlBuilderVB
        Inherits ControlBuilder

        Public Overrides Function GetChildControlType(ByVal tagName As String, ByVal attribs As IDictionary) As Type

            ' Allows TableRow without "runat=server" attribute to be added to the collection.
            If (String.Compare(tagName, "mycell", True) = 0) Then
                Return GetType(MyCell)
            End If
            Return Nothing
        End Function

        ' Ignores literals between rows.
        Public Overrides Sub AppendLiteralString(ByVal s As String)
            ' Ignores literals between rows.
        End Sub

    End Class

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal), ControlBuilderAttribute(GetType(MyControlBuilderVB))> _
        Public Class MyVB_CustomControl
        Inherits Control
        Implements INamingContainer

        ' Class name: MyVB_CustomControl.
        ' Processes the element declarations within a control 
        ' declaration. This builds the actual control.

        ' Custom control to build programmatically.
        Private _table As Table

        Private _cellObjects As New Hashtable()

        ' Variables that must contain the control attributes as defined in the Web page.
        Private _rows As Integer
        Private _columns As Integer
        Private _title As String

        ' Rows property to be used as the attribute name in the Web page.     
        Public Property Rows() As Integer
            Get
                Return _rows
            End Get
            Set(ByVal value As Integer)
                _rows = value
            End Set
        End Property

        ' Columns property to be used as the attribute name in the Web page.

        Public Property Columns() As Integer
            Get
                Return _columns
            End Get
            Set(ByVal value As Integer)
                _columns = value
            End Set
        End Property

        ' Title property to be used as the attribute name in the Web page   
        Public Property Title() As String
            Get
                Return _title
            End Get
            Set(ByVal value As String)
                _title = value
            End Set
        End Property


        Protected Sub createNewRow(ByVal rowNumber As Integer)

            ' Creates a row and adds it to the table.
            Dim row As TableRow

            row = New TableRow()
            _table.Rows.Add(row)

            ' Creates a cell that contains text.
            Dim y As Integer
            For y = 0 To Columns - 1
                appendCell(row, rowNumber, y)
            Next y
        End Sub


        Protected Sub appendCell(ByVal row As TableRow, ByVal rowNumber As Integer, ByVal cellNumber As Integer)
            Dim cell As TableCell
            Dim textbox As TextBox

            cell = New TableCell()

            textbox = New TextBox()

            cell.Controls.Add(textbox)

            textbox.ID = "r" + rowNumber.ToString() + "c" + cellNumber.ToString()

            ' Checks for the MyCell child object.
            If Not (_cellObjects(textbox.ID) Is Nothing) Then
                Dim cellLookup As MyCell
                cellLookup = CType(_cellObjects(textbox.ID), MyCell)

                textbox.Text = cellLookup.Text
                textbox.BackColor = cellLookup.BackColor

            Else
                textbox.Text = "Row: " + rowNumber.ToString() + " Cell: " + cellNumber.ToString()
            End If

            row.Cells.Add(cell)
        End Sub

        ' Called at runtime when a child object is added to the collection.
        Protected Overrides Sub AddParsedSubObject(ByVal obj As Object)

            Dim cell As MyCell = CType(obj, MyCell)
            If Not (cell Is Nothing) Then
                _cellObjects.Add(cell.CellID, cell)
            End If
        End Sub


        Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
            ' Sub name: OnPreRender.
            ' Carries out changes affecting the control state and renders the resulting UI.

            ' Increases the number of rows if needed.
            While _table.Rows.Count < Rows
                createNewRow(_table.Rows.Count)
            End While

            ' Checks that each row has the correct number of columns.
            Dim i As Integer
            For i = 0 To _table.Rows.Count - 1
                While _table.Rows(i).Cells.Count < Columns
                    appendCell(_table.Rows(i), i, _table.Rows(i).Cells.Count)
                End While

                While _table.Rows(i).Cells.Count > Columns
                    _table.Rows(i).Cells.RemoveAt((_table.Rows(i).Cells.Count - 1))
                End While
            Next i
        End Sub


        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
        Protected Overrides Sub CreateChildControls()
            ' Sub name: CreateChildControls.
            ' Adds the Table and the text controls to the control collection. 


            Dim [text] As LiteralControl

            ' Initializes the text control using the Title property.
            [text] = New LiteralControl("<h5>" + Title + "</h5>")
            Controls.Add([text])


            _table = New Table()

            Controls.Add(_table)
        End Sub
    End Class

End Namespace

Aşağıdaki kod örneği önceki özel denetimi kullanır. Özellikle, öznitelikleri ve içeriği çalışma zamanında tanımlanan bir tablo oluşturur. @ Register yönergesinde gösterilen değerlerin önceki komut satırını yansıttığını göreceksiniz.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="AspNetSamples" Assembly="cs_mycontrolbuilder" Namespace="CustomControls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ControlBuilder Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <AspNetSamples:MyCS_CustomControl id="Custom1" 
                                         title="Auto-Generated Table"
                                         columns="3"
                                         rows="3"  
                                         runat="server">
         <mycell cellid="r0c0" BackColor="red" text="red cell"></mycell>
         <mycell cellid="r2c2" BackColor="green" text="green cell"></mycell>
       </AspNetSamples:MyCS_CustomControl>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register TagPrefix="AspNetSamples" Assembly="vb_mycontrolbuilder" Namespace="CustomControls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ControlBuilder Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <AspNetSamples:MyVB_CustomControl id="Custom1" 
                                         title="Auto-Generated Table"
                                         columns="3"
                                         rows="3"  
                                         runat="server">
         <mycell cellid="r0c0" BackColor="red" text="red cell"></mycell>
         <mycell cellid="r2c2" BackColor="green" text="green cell"></mycell>
       </AspNetSamples:MyVB_CustomControl>
    </div>
    </form>
</body>
</html>

Açıklamalar

Varsayılan olarak, sayfadaki her denetim varsayılan ControlBuilder bir sınıfla ilişkilendirilir. Ayrıştırma sırasında, ASP.NET sayfa çerçevesi sayfanın denetim ağacına karşılık gelen bir nesne ağacı ControlBuilder oluşturur. Ardından ControlBuilder ağaç, denetim ağacını oluşturmak üzere sayfa kodu oluşturmak için kullanılır. alt denetimlere ek olarak, ControlBuilder denetim etiketleri içindeki içeriğin nasıl ayrıştırıldığındaki davranışını tanımlar. Kendi özel denetim oluşturucu sınıfınızı tanımlayarak bu varsayılan davranışı geçersiz kılabilirsiniz. Bu, denetim oluşturucu sınıfınıza aşağıdaki gibi bir ControlBuilderAttribute öznitelik uygulanarak yapılır:

[ControlBuilderAttribute(typeof(ControlBuilderType))]

Oluşturucular

ControlBuilder()

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

Alanlar

DesignerFilter

Değişmez değer dizesini "__designer" temsil eder.

Özellikler

BindingContainerBuilder	Bu oluşturucunun oluşturduğu denetim için bağlama kapsayıcısına karşılık gelen denetim oluşturucusunu alır.
BindingContainerType	Bu oluşturucunun oluşturduğu denetim için bağlama kapsayıcısının türünü alır.
ComplexPropertyEntries	Karmaşık özellik girişlerinden oluşan bir koleksiyon alır.
ControlType	Type Oluşturulacak denetimin öğesini alır.
CurrentFilterResolutionService	Tasarımcıda denetimleri ayrıştırırken ve kalıcı hale getirmek için cihaz filtresiyle ilgili hizmetleri yönetmek için kullanılan nesneyi IFilterResolutionService alır.
DeclareType	Denetimi bildirmek için kod oluşturma tarafından kullanılacak türü alır.
FChildrenAsProperties	Denetimin değerine ayarlanmış `true`bir değerine sahip olup olmadığını belirleyen bir ParseChildrenAttribute ChildrenAsProperties değer alır.
FIsNonParserAccessor	Denetimin arabirimi uygulayıp uygulamadığını IParserAccessor belirleyen bir değer alır.
HasAspCode	Denetimin kod blokları içerip içermediğini belirten bir değer alır.
ID	Oluşturulacak denetimin tanımlayıcı özelliğini alır veya ayarlar.
InDesigner	öğesinin ControlBuilder tasarımcıda çalışıp çalışmadığını döndürür.
InPageTheme	Bu ControlBuilder nesnenin sayfa temaları oluşturmak için kullanılıp kullanılmadığını belirten bir Boole değeri alır.
ItemType	Bağlama kapsayıcısı üzerinde ayarlanan türü alır.
Localize	Bu ControlBuilder nesne tarafından oluşturulan denetimin yerelleştirilip oluşturulmadığını belirten bir Boole değeri alır.
NamingContainerType	Bu oluşturucunun oluşturduğu denetimin adlandırma kapsayıcısının türünü alır.
PageVirtualPath	Bu ControlBuilder örnek tarafından oluşturulacak sayfanın sanal yolunu alır.
Parser	TemplateParser Denetimi ayrıştırma sorumluluğunu alır.
ServiceProvider	Bu ControlBuilder nesne için hizmet nesnesini alır.
SubBuilders	Bu ControlBuilder nesne için alt ControlBuilder nesnelerin listesini alır.
TagName	Oluşturulacak denetimin etiket adını alır.
TemplatePropertyEntries	Şablon özelliği girdileri koleksiyonunu alır.
ThemeResolutionService	Denetim temalarını ve dış görünümlerini yönetmek için tasarım zamanında kullanılan bir IThemeResolutionService nesneyi alır.

Yöntemler

AllowWhitespaceLiterals()	Denetimin açma ve kapatma etiketleri arasında içerikte boşluk değişmez değerlerine izin verilip verilmeyeceğini belirler. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
AppendLiteralString(String)	Belirtilen değişmez değeri bir denetime ekler. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
AppendSubBuilder(ControlBuilder)	Kapsayıcı denetimine ControlBuilder ait tüm alt denetimler için nesneye oluşturucular ekler.
BuildObject()	Bu ControlBuilder nesne tarafından başvuruda bulunılan denetimin tasarım zamanı örneğini oluşturur.
CloseControl()	Oluşturucuyu denetimin açma ve kapatma etiketlerinin ayrıştırma işleminin tamamlandığını bildirmek için ayrıştırıcı tarafından çağrılır.
CreateBuilderFromType(TemplateParser, ControlBuilder, Type, String, String, IDictionary, Int32, String)	Belirtilen etiket adından ve nesne türünden ve oluşturucuyu tanımlayan diğer parametrelerden bir ControlBuilder nesne oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetChildControlType(String, IDictionary)	Type Bir alt etikete karşılık gelen denetim türünün değerini alır. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectPersistData()	ObjectPersistData Bu ControlBuilder nesne için nesnesini oluşturur.
GetResourceKey()	Bu ControlBuilder nesnenin kaynak anahtarını alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HasBody()	Denetimin hem açma hem de kapatma etiketi olup olmadığını belirler. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
HtmlDecodeLiterals()	Bir HTML denetiminin değişmez değer dizesinin HTML kodunun çözülmesi gerekip gerekmediğini belirler. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)	örneği başlatıldıktan sonra kullanılacak öğesini ControlBuilder başlatır. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
NeedsTagInnerText()	Denetim oluşturucusunun iç metnini alması gerekip gerekmediğini belirler. Bu durumda yöntemi SetTagInnerText(String) çağrılmalıdır. Bu yöntem, ASP.NET sayfa çerçevesi tarafından çağrılır.
OnAppendToParentBuilder(ControlBuilder)	ControlBuilder Üst denetim oluşturucusunun eklendiğini bildirir.
ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)	Özel denetim oluşturucularının oluşturulan Kod Belgesi Nesne Modeli'ne (CodeDom) erişmesini ve denetimleri ayrıştırma ve derleme işlemi sırasında kod eklemesini ve değiştirmesini sağlar.
SetResourceKey(String)	Bu ControlBuilder nesnenin kaynak anahtarını ayarlar.
SetServiceProvider(IServiceProvider)	Bu ControlBuilder nesne için hizmet nesnesini ayarlar.
SetTagInnerText(String)	ControlBuilder denetim etiketinin iç metnini sağlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır

Aracılığıyla paylaş