ListControlDesigner Sınıf

Tanım

public ref class ListControlDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceProvider

public ref class ListControlDesigner : System::Web::UI::Design::WebControls::DataBoundControlDesigner

public class ListControlDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceProvider

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class ListControlDesigner : System.Web.UI.Design.WebControls.DataBoundControlDesigner

type ListControlDesigner = class
    inherit ControlDesigner
    interface IDataSourceProvider

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type ListControlDesigner = class
    inherit DataBoundControlDesigner

Public Class ListControlDesigner
Inherits ControlDesigner
Implements IDataSourceProvider

Public Class ListControlDesigner
Inherits DataBoundControlDesigner

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ListControlDesigner

Devralma

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

ListControlDesigner

Türetilmiş

System.Web.UI.Design.WebControls.BulletedListDesigner

Öznitelikler

SupportsPreviewControlAttribute

Uygulamalar

IDataSourceProvider

Örnekler

Bu bölümde iki kod örneği verilmiştir. İlki, özel denetim tasarımcısının nasıl türetilmiş olduğunu gösterir. İkincisinde türetilmiş bir denetimin bir tasarımcıyla nasıl ilişkilendirilecekleri gösterilmektedir.

Aşağıdaki kod örneği, sınıfından devralan adlı SimpleRadioButtonListDesigner bir sınıfın ListControlDesigner nasıl oluşturulacağını gösterir. SimpleRadioButtonListDesigner sınıfı , Initializeve OnDataSourceChanged yöntemlerini geçersiz kılarGetDesignTimeHtml. sınıfı tasarım SimpleRadioButtonListDesigner yüzeyinde bir SimpleRadioButtonList denetim görüntüler.

using System;
using System.ComponentModel;
using System.Drawing;
using System.Diagnostics;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;

namespace Examples.CS.WebControls.Design
{
    // Create the SimpleRadioButtonListDesigner, which provides
    // design-time support for a custom list class.
    public class SimpleRadioButtonListDesigner : ListControlDesigner
    {
        SimpleRadioButtonList simpleRadioButtonList;
        bool changedDataSource;

        // Create the markup to display the control on the design surface. 
        public override string GetDesignTimeHtml()
        {
            string designTimeMarkup = null;

            // Create variables to access the control
            // item collection and back color.
            ListItemCollection items = simpleRadioButtonList.Items;
            Color oldBackColor = simpleRadioButtonList.BackColor;

            // Check the property values and render the markup
            // on the design surface accordingly.
            try
            {
                if (oldBackColor == Color.Empty)
                    simpleRadioButtonList.BackColor = Color.Gainsboro;

                if (changedDataSource)
                    items.Add("Updated to a new data source: " + 
                        DataSource + ".");

                // Call the base method to generate the markup.
                designTimeMarkup = base.GetDesignTimeHtml();
            }
            catch (Exception ex)
            {
                // Catch any exceptions that occur.
                designTimeMarkup = GetErrorDesignTimeHtml(ex);
            }
            finally
            {
                // Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor;
                items.Clear();
            }

            return designTimeMarkup;
        } // GetDesignTimeHtml

        public override void Initialize(IComponent component)
        {
            // Ensure that only a SimpleRadioButtonList can be 
            // created in this designer.
            Debug.Assert( 
                component is SimpleRadioButtonList, 
                "An invalid SimpleRadioButtonList control was initialized.");

            simpleRadioButtonList = (SimpleRadioButtonList)component;
            base.Initialize(component);
        } // Initialize

        // If the data source changes, set a boolean variable.
        public override void OnDataSourceChanged()
        {
            changedDataSource = true;
        } // OnDataSourceChanged
    } // SimpleRadioButtonListDesigner
} // Examples.CS.WebControls.Design

Imports System.ComponentModel
Imports System.Drawing
Imports System.Diagnostics
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.VB.WebControls.Design

    ' Create the SimpleRadioButtonListDesigner, which provides
    ' design-time support for a custom list class.  
    Public Class SimpleRadioButtonListDesigner
        Inherits ListControlDesigner

        Private simpleRadioButtonList As SimpleRadioButtonList
        Private changedDataSource As Boolean

        ' Create the markup to display the control on the design surface.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim designTimeHtml As String = String.Empty

            ' Create variables to access the control's
            ' item collection and back color. 
            Dim items As ListItemCollection = simpleRadioButtonList.Items
            Dim oldBackColor As Color = simpleRadioButtonList.BackColor

            ' Check the property values and render the markup
            ' on the design surface accordingly.
            Try
                If (Color.op_Equality(oldBackColor, Color.Empty)) Then
                    simpleRadioButtonList.BackColor = Color.Gainsboro
                End If

                If (changedDataSource) Then
                    items.Add( _
                        "Updated to a new data source: " & DataSource & ".")
                End If

                designTimeHtml = MyBase.GetDesignTimeHtml()

            Catch ex As Exception
                ' Catch any exceptions that occur.
                MyBase.GetErrorDesignTimeHtml(ex)

            Finally
                ' Set the properties back to their original state.
                simpleRadioButtonList.BackColor = oldBackColor
                items.Clear()
            End Try

            Return designTimeHtml
        End Function ' GetDesignTimeHtml

        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a SimpleRadioButtonList can be created 
            ' in this designer.
            Debug.Assert( _
                TypeOf component Is SimpleRadioButtonList, _
                "An invalid SimpleRadioButtonList control was initialized.")

            simpleRadioButtonList = CType(component, SimpleRadioButtonList)
            MyBase.Initialize(component)
        End Sub

        ' If the data source changes, set a Boolean variable.
        Public Overrides Sub OnDataSourceChanged()
            changedDataSource = True
        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Aşağıdaki kod örneği denetiminden türetir SimpleRadioButtonList ve denetimi tasarımcısı SimpleRadioButtonListDesigner olan sınıfıyla ilişkilendirmek SimpleRadioButtonList için sınıfının nasıl kullanılacağını DesignerAttribute gösterir.RadioButtonList

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

namespace Examples.CS.WebControls.Design
{
    // The SimpleRadioButtonList is a copy of the RadioButtonList.
    // It uses the SimpleRadioButtonListDesigner for design-time support.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.
       SimpleRadioButtonListDesigner))]
    [DataBindingHandler(typeof(Examples.CS.WebControls.Design.
        SimpleRadioButtonListDataBindingHandler))]
    public class SimpleRadioButtonList : RadioButtonList
    {
    } // SimpleRadioButtonList
} // Examples.CS.WebControls.Design

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

Namespace Examples.VB.WebControls.Design

    ' The SimpleRadioButtonList is a copy of the RadioButtonList.
    ' It uses the SimpleRadioButtonListDesigner for design-time support.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <DesignerAttribute(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDesigner))> _
    <DataBindingHandler(GetType(Examples.VB.WebControls.Design. _
        SimpleRadioButtonListDataBindingHandler))> _
    Public Class SimpleRadioButtonList
        Inherits RadioButtonList
    End Class
End Namespace ' Examples.VB.WebControls.Design

Açıklamalar

Visual Web Tasarım Aracı kullanıcı Kaynak görünümünden Tasarım görünümüne geçtiğinde, sınıftan ListControl türetilen bir denetimi açıklayan işaretleme kaynak kodu ayrıştırılır ve tasarım yüzeyinde denetimin tasarım zamanı sürümü oluşturulur. Kullanıcı Kaynak görünümüne geri döndüğünde, tasarım zamanı denetimi işaretleme kaynak kodunda kalıcı olur ve Web sayfasının işaretlemesinde düzenlenir. sınıfı, ListControlDesigner içinden türetilen ListControldenetimler için Visual Web Tasarım Aracı tasarım zamanı desteği sağlayan tasarımcılar için temel sınıf görevi görür.

ListControlDesigner Sınıf özellikleri aşağıdaki işlevleri sağlar:

• ActionLists özelliği, genellikle tasarımcının devralma ağacındaki her düzey için nesneden DesignerActionList türetilmiş bir nesne içeren bir nesnesi döndürürDesignerActionListCollection.

• DataTextField ve DataValueField özellikleri, sınıfından türetilen bir denetimin karşılık gelen özelliklerine ListControl erişim sağlar. DataTextField veDataValueField, sırasıyla liste öğelerinin metin ve değer içeriğini sağlayan veri kaynağının alanlarını gösterir.

ListControlDesigner Sınıf yöntemleri aşağıdaki işlevleri sağlar:

• yöntemi, DataBind 'den ListControl türetilen ilişkili denetimi bir tasarım zamanı veri kaynağına bağlar.

• yöntemi, GetDesignTimeHtml tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi döndürür.

• yöntemi, GetSelectedDataSource ilişkili denetim kapsayıcısından tasarım zamanı DataSource bileşenini döndürür.

• GetResolvedSelectedDataSource yöntemi, denetimin tasarım zamanı DataMember özelliğine çözümlenen denetim kapsayıcısından öğesini döndürürDataSource.

• Initialize yöntemi, tasarımcıyı içinden türetilen ilişkili denetimi görüntülemeye ve tasarlamaya ListControlhazırlar.

• yöntemi OnDataSourceChanged , ilişkili denetim için değiştirildiğinde DataSource çağrılır.

• PreFilterProperties yöntemi, 'den ek özellikleri kaldırmak, öğesine ek özellikler eklemek veya içinden türetilen ListControlilişkili denetimin gölge özelliklerini eklemek için kullanılır.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• ListControl
• DataBoundControl
• DataBoundControlDesigner
• BaseDataBoundControl
• BaseDataBoundControlDesigner
• WebControl
• ControlDesigner
• ASP.NET Denetim Tasarımcılarına Giriş
• İzlenecek yol: Web Sunucusu Denetimi için Temel Denetim Tasarım Aracı Oluşturma