TemplateGroupCollection Clase

Definición

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

Herencia

Object

TemplateGroupCollection

Implementaciones

ICollection IEnumerable IList

Ejemplos

En el ejemplo de código siguiente se muestra cómo definir un diseñador de controles simple derivado de la ControlDesigner clase . El diseñador de controles derivado implementa la TemplateGroups propiedad obteniendo los grupos de plantillas definidos para la clase base y agregando un grupo de plantillas específico para el diseñador de controles derivado.

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

Comentarios

La ControlDesigner clase y cualquier clase derivada definen la TemplateGroups propiedad como un TemplateGroupCollection objeto . Normalmente TemplateGroupCollection , una host de diseño usa la propiedad , como Visual Studio 2005.

La colección aumenta dinámicamente el tamaño a medida que se agregan objetos. Los índices de esta colección se basan en cero. Use la Count propiedad para determinar cuántos grupos hay en la colección.

Además, use los TemplateGroupCollection métodos y propiedades para proporcionar la siguiente funcionalidad:

• Método Add para agregar un único grupo a la colección.

• Método Insert para agregar un grupo en un índice determinado dentro de la colección.

• Método Remove para quitar un grupo.

• Método RemoveAt para quitar el grupo en un índice determinado.

• Método Contains para determinar si un grupo determinado ya está en la colección.

• Método IndexOf para recuperar el índice de un grupo dentro de la colección.

• Indexador Item[] que se va a obtener o establecer el grupo en un índice determinado, mediante la notación de matriz.

• Método AddRange para agregar varios grupos a la colección.

  Puede agregar varios grupos como una matriz de grupos o como un TemplateGroupCollection objeto que se recupera a través de la TemplateGroups propiedad de otro diseñador de controles.

• Método Clear para quitar todos los grupos de la colección.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

• TemplateGroups
• TemplateGroup
• TemplateDefinition
• Introducción a los diseñadores de controles de ASP.NET
• Ampliar compatibilidad en tiempo de diseño
• Cómo: Extender la apariencia y el comportamiento de los controles en modo de diseño