TemplateGroupCollection Sınıf

Tanım

public ref class TemplateGroupCollection sealed : System::Collections::IList

public sealed class TemplateGroupCollection : System.Collections.IList

type TemplateGroupCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class TemplateGroupCollection
Implements IList

Devralma

Object

TemplateGroupCollection

Uygulamalar

ICollection IEnumerable IList

Örnekler

Aşağıdaki kod örneği, sınıfından ControlDesigner türetilen basit bir denetim tasarımcısının nasıl tanımlandığını gösterir. Türetilmiş denetim tasarımcısı, temel sınıf için tanımlanan şablon gruplarını alarak ve türetilmiş denetim tasarımcısına özgü bir şablon grubu ekleyerek özelliğini uygular TemplateGroups .

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

namespace Examples.AspNet
{
    // Define a simple control designer that adds a
    // template group to the template group collection.
    class DerivedControlDesigner : System.Web.UI.Design.ControlDesigner
    {
        private DerivedControl internalControl = null;

        private const String templateGroupName = "My template group";
        private const String templateDefinitionName1 = "First";
        private const String templateDefinitionName2 = "Second";
        private TemplateGroup internalGroup = null;

        // Override the read-only TemplateGroups property.
        // Get the base group collection, and add a group 
        // with two template definitions for the derived
        // control designer.
        public override TemplateGroupCollection TemplateGroups
        {
            get
            {
                // Start with the groups defined by the base designer class.
                TemplateGroupCollection groups = base.TemplateGroups;

                if (internalGroup == null) 
                {
                    // Define a new group with two template definitions.
                    internalGroup = new TemplateGroup(templateGroupName, 
                                                internalControl.ControlStyle);

                    TemplateDefinition templateDef1 = new TemplateDefinition(this, 
                        templateDefinitionName1, internalControl, 
                        templateDefinitionName1, internalControl.ControlStyle);

                    TemplateDefinition templateDef2 = new TemplateDefinition(this, 
                        templateDefinitionName2, internalControl, 
                        templateDefinitionName2, internalControl.ControlStyle);

                    internalGroup.AddTemplateDefinition(templateDef1);
                    internalGroup.AddTemplateDefinition(templateDef2);
                }

                // Add the new template group to the collection.
                groups.Add(internalGroup);

                return groups;
            }
        }
    }

    // Define a simple web control, and associate it with the designer.
    [DesignerAttribute(typeof(DerivedControlDesigner),
                       typeof(IDesigner))]
    public class DerivedControl : WebControl
    {
        // Define derived control behavior here.
    }
}

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

Namespace Examples.AspNet

    ' Define a simple control designer that adds a
    ' template group to the template group collection.
    Class DerivedControlDesigner
        Inherits System.Web.UI.Design.ControlDesigner

        Private Dim internalControl As DerivedControl = Nothing
    
        Private Const templateGroupName As String = "My template group"
        Private Const templateDefinitionName1 As String = "First"
        Private Const templateDefinitionName2 As String = "Second"
        Private Dim internalGroup As TemplateGroup = Nothing

        ' Override the read-only TemplateGroups property.
        ' Get the base group collection, and add a group 
        ' with two template definitions for the derived
        ' control designer.
        Public Overrides ReadOnly Property TemplateGroups As TemplateGroupCollection
            Get

                ' Start with the groups defined by the base designer class.
                Dim groups As TemplateGroupCollection  = MyBase.TemplateGroups

                If internalGroup Is Nothing

                    ' Define a new group with two template definitions.
                    internalGroup = New TemplateGroup(templateGroupName, _
                                                internalControl.ControlStyle)

                    Dim templateDef1 As TemplateDefinition = new TemplateDefinition(Me, _
                        templateDefinitionName1, internalControl, _
                        templateDefinitionName1, internalControl.ControlStyle)

                    Dim templateDef2 As TemplateDefinition = new TemplateDefinition(Me, _
                        templateDefinitionName2, internalControl, _
                        templateDefinitionName2, internalControl.ControlStyle)

                    internalGroup.AddTemplateDefinition(templateDef1)
                    internalGroup.AddTemplateDefinition(templateDef2)

                End If

                ' Add the new template group to the collection.
                groups.Add(internalGroup)

                return groups
            End Get
        End Property

    End Class

    ' Simple Web control, derived from the Web control class.
    <DesignerAttribute(GetType(DerivedControlDesigner), GetType(IDesigner))> _
    Public Class DerivedControl
        Inherits WebControl
        
        ' Define derived control behavior here.
    End Class

End Namespace

Açıklamalar

ControlDesigner sınıfı ve türetilmiş herhangi bir sınıf, özelliğini nesne TemplateGroupCollection olarak tanımlarTemplateGroups. TemplateGroupCollection özelliği genellikle yalnızca Visual Studio 2005 gibi bir tasarım konağı tarafından kullanılır.

Nesneler eklendikçe koleksiyonun boyutu dinamik olarak artar. Bu koleksiyondaki dizinler sıfır tabanlıdır. Koleksiyonda Count kaç grup olduğunu belirlemek için özelliğini kullanın.

Ayrıca, aşağıdaki işlevleri sağlamak için yöntemleri ve özellikleri kullanın TemplateGroupCollection :

• Add Koleksiyona tek bir grup ekleme yöntemi.

• Insert Koleksiyon içindeki belirli bir dizine grup ekleme yöntemi.

• Bir Remove grubu kaldırma yöntemi.

• RemoveAt Belirli bir dizindeki grubu kaldırma yöntemi.

• Contains Belirli bir grubun koleksiyonda olup olmadığını belirleme yöntemi.

• IndexOf Koleksiyondaki bir grubun dizinini alma yöntemi.

• Dizi Item[] gösterimini kullanarak grubu belirli bir dizinde alacak veya ayarlayan dizin oluşturucu.

• AddRange Koleksiyona birden çok grup ekleme yöntemi.

  Birden çok grubu bir grup dizisi veya başka bir denetim tasarımcısının TemplateGroups özelliği aracılığıyla aldığınız bir TemplateGroupCollection nesne olarak ekleyebilirsiniz.

• Clear Koleksiyondaki tüm grupları kaldırma yöntemi.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• TemplateGroups
• TemplateGroup
• TemplateDefinition
• ASP.NET Denetim Tasarımcılarına Genel Bakış
• Tasarım Zamanı Desteği Sunma
• Nasıl yapılır: Tasarım Modunda Denetimlerin Görünüşü ve Davranışını Genişletme