TemplateGroupCollection Třída

Definice

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

Dědičnost

Object

TemplateGroupCollection

Implementuje

ICollection IEnumerable IList

Příklady

Následující příklad kódu ukazuje, jak definovat jednoduchý ovládací prvek návrhář, který je odvozen z ControlDesigner třídy. Návrhář odvozených ovládacích prvků implementuje TemplateGroups vlastnost získáním skupin šablon, které jsou definovány pro základní třídu a přidáním skupiny šablon, která je specifická pro návrhář odvozených ovládacích prvků.

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

Poznámky

Třída ControlDesigner a jakákoli odvozená třída definuje TemplateGroups vlastnost jako TemplateGroupCollection objekt. Vlastnost TemplateGroupCollection obvykle používá pouze hostitel návrhu, například Visual Studio 2005.

Při přidání objektů se kolekce dynamicky zvětšuje. Indexy v této kolekci jsou založené na nule. Count Pomocí vlastnosti určete, kolik skupin je v kolekci.

Kromě toho použijte TemplateGroupCollection metody a vlastnosti k zajištění následujících funkcí:

• Metoda Add pro přidání jedné skupiny do kolekce.

• Metoda Insert pro přidání skupiny do konkrétního indexu v rámci kolekce.

• Metoda Remove odebrání skupiny.

• Metoda RemoveAt odebrání skupiny v určitém indexu.

• Metoda Contains k určení, zda je konkrétní skupina již v kolekci.

• Metoda IndexOf načtení indexu skupiny v rámci kolekce.

• Indexer Item[] pro získání nebo nastavení skupiny v určitém indexu pomocí zápisu pole.

• Metoda AddRange pro přidání více skupin do kolekce.

  Více skupin můžete přidat buď jako pole skupin, nebo jako TemplateGroupCollection objekt, který načtete prostřednictvím TemplateGroups vlastnosti jiného návrháře ovládacích prvků.

• Metoda Clear pro odebrání všech skupin z kolekce.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• TemplateGroups
• TemplateGroup
• TemplateDefinition
• Přehled návrhářů ovládacích prvků ASP.NET
• Rozšíření podpory během návrhu
• Postupy: Rozšíření vzhledu a chování ovládacích prvků v režimu návrhu