This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ListControlDesigner الفئة

Visual Studio 2010

يعمل كفئة أساسية لمصممي تقديم دعم وقت التصميم في "مصمم ويب Visual Basic" ل عناصر التحكم التي تنتج من ListControlclass. مجردة

مساحة الاسم:  System.Web.UI.Design.WebControls
التجميع:  System.Design (في System.Design.dll)

[SupportsPreviewControlAttribute(true)]
[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public class ListControlDesigner : DataBoundControlDesigner

في "مصمم ويب" Vهوual "، عند تبديل مستخدم من المصدر إلى عرض" تصميم "، تعليمات برمجية المصدر ترميز التي تصف عنصر تحكم المشتقة من ListControlالفئة هو تحليل والإصدار وقت التصميم من عنصر التحكم هو التي تم إنشاؤها تشغيل سطح التصميم. عندما ينتقل مستخدم إلى مصدر عرض التصميم-الوقت الدائمة للتعليمات البرمجية المصدر علامات التحكم وتحريرها في ترميز لصفحة ويب. ListControlDesigner يخدم الفئة كفئة أساسية للمصممين توفير دعم لوقت التصميم في "مصمم ويب" Visual Basic لعناصر التحكم التي تنتج من ListControl.

ListControlDesigner توفر خصائص فئة الوظائف التالية:

  • The ActionLists خاصية إرجاع a DesignerActionListCollection كائن, which typically يحتوي على an كائن that هو derived من the DesignerActionList كائن for each المستوى في the توريث شجرة of the مصمم.

  • The DataTextField و DataValueField خصائص provide الوصول إلى the corresponding خصائص of a عنصر تحكم that هو derived من the ListControl فئة. DataTextField و DataValueFieldالإشارة إلى حقول مصدر البيانات الذي يوفر محتوى نص وقيمة من قائمة العناصر، على التوالي.

ListControlDesigner فئة وظائف توفير الوظائف التالية:

  • DataBind التحكم المقترنة الروابط الأسلوب الذي هو مشتقة من ListControlإلى مصدر البيانات وقت التصميم.

  • GetDesignTimeHtml الأسلوب بإرجاع ترميز التي هو المستخدمة لتقديم عنصر التحكم المرفق في وقت التصميم.

  • The GetSelectedDataSource أسلوب إرجاع the تصميم-الوقت DataSource مكوّن من the associated عنصر تحكم حاوية.

  • The GetResolvedSelectedDataSource أسلوب إرجاع the DataSource من the عنصر تحكم حاوية, حل إلى the تصميم-الوقت DataMember خاصية of the عنصر تحكم.

  • The Initialize أسلوب prepares the مصمم إلى عرض و تصميم the associated عنصر تحكم that هو derived من the ListControl.

  • The OnDataSourceChanged أسلوب هو called when the DataSource for the associated عنصر تحكم قد تغير.

  • The PreFilterProperties أسلوب هو used إلى إزالة إضافى خصائص من, إضافة إضافى خصائص إلى, أو shadow خصائص of the associated عنصر تحكم that هو derived من the ListControl.

يوفر هذا القسم أمثلة تعليمات برمجية الثاني. The أول demonstrates how إلى derive a مخصص عنصر تحكم مصمم. The ثانية demonstrates how إلى associate a derived عنصر تحكم مع a مصمم.

The following تعليمات برمجية مثال shows how إلى إنشاء a فئة named SimpleRadioButtonListDesigner that inherits من the ListControlDesigner فئة. The SimpleRadioButtonListDesigner فئة overrides the GetDesignTimeHtml, Initialize, و OnDataSourceChanged وظائف. SimpleRadioButtonListDesignerتعرض لفئة SimpleRadioButtonListعنصر تحكم على سطح التصميم.


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


The following تعليمات برمجية مثال derives the SimpleRadioButtonList عنصر تحكم من the RadioButtonList عنصر تحكم, و shows how إلى استخدم the DesignerAttribute فئة إلى associate the SimpleRadioButtonList عنصر تحكم مع its مصمم, the SimpleRadioButtonListDesigner فئة.


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


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: