TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection Class

Définition

Représente une collection d’objets TemplateGroup dans un concepteur de contrôles.Represents a collection of TemplateGroup objects within a control designer. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
Héritage
TemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollection
Implémente

Exemples

L’exemple de code suivant montre comment définir un concepteur de contrôles simple dérivé de la ControlDesigner classe.The following code example demonstrates how to define a simple control designer that is derived from the ControlDesigner class. Le concepteur de contrôles dérivés implémente la TemplateGroups propriété en obtenant les groupes de modèles définis pour la classe de base et en ajoutant un groupe de modèles spécifique au concepteur de contrôles dérivé.The derived control designer implements the TemplateGroups property by getting the template groups that are defined for the base class and adding a template group that is specific to the derived control designer.

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

Remarques

La ControlDesigner classe, et toute classe dérivée, définit TemplateGroups la propriété en TemplateGroupCollection tant qu’objet.The ControlDesigner class, and any derived class, defines the TemplateGroups property as a TemplateGroupCollection object. La TemplateGroupCollection propriété est généralement utilisée uniquement par un hôte de conception tel Visual Studio 2005Visual Studio 2005que.The TemplateGroupCollection property is typically used only by a design host such as Visual Studio 2005Visual Studio 2005.

La taille de la collection augmente dynamiquement au fur et à mesure que des objets sont ajoutés.The collection dynamically increases in size as objects are added. Les index de cette collection sont de base zéro.Indexes in this collection are zero-based. Utilisez la Count propriété pour déterminer le nombre de groupes dans la collection.Use the Count property to determine how many groups are in the collection.

En outre, utilisez les TemplateGroupCollection méthodes et les propriétés pour fournir les fonctionnalités suivantes:Additionally, use the TemplateGroupCollection methods and properties to provide the following functionality:

  • Add Méthode permettant d’ajouter un seul groupe à la collection.The Add method to add a single group to the collection.

  • Insert Méthode permettant d’ajouter un groupe à un index particulier dans la collection.The Insert method to add a group at a particular index within the collection.

  • Remove Méthode permettant de supprimer un groupe.The Remove method to remove a group.

  • RemoveAt Méthode permettant de supprimer le groupe au niveau d’un index particulier.The RemoveAt method to remove the group at a particular index.

  • Contains Méthode permettant de déterminer si un groupe particulier figure déjà dans la collection.The Contains method to determine whether a particular group is already in the collection.

  • IndexOf Méthode permettant de récupérer l’index d’un groupe dans la collection.The IndexOf method to retrieve the index of a group within the collection.

  • Indexeur permettant d’obtenir ou de définir le groupe au niveau d’un index particulier, à l’aide de la Item[Int32] notation de tableau.The Item[Int32] indexer to get or set the group at a particular index, using array notation.

  • AddRange Méthode permettant d’ajouter plusieurs groupes à la collection.The AddRange method to add multiple groups to the collection.

    Vous pouvez ajouter plusieurs groupes en tant que tableau de groupes ou en tant TemplateGroupCollection qu’objet que vous récupérez TemplateGroups par le biais de la propriété d’un autre concepteur de contrôles.You can add multiple groups either as an array of groups or as a TemplateGroupCollection object that you retrieve through the TemplateGroups property of another control designer.

  • Clear Méthode permettant de supprimer tous les groupes de la collection.The Clear method to remove all groups from the collection.

Constructeurs

TemplateGroupCollection() TemplateGroupCollection() TemplateGroupCollection() TemplateGroupCollection()

Initialise une nouvelle instance de la classe TemplateGroupCollection.Initializes a new instance of the TemplateGroupCollection class.

Propriétés

Count Count Count Count

Obtient le nombre d'objets TemplateGroup dans la collection.Gets the number of TemplateGroup objects in the collection.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtient ou définit un objet TemplateGroup dans la collection à l'index spécifié.Gets or sets a TemplateGroup object at the specified index in the collection.

Méthodes

Add(TemplateGroup) Add(TemplateGroup) Add(TemplateGroup) Add(TemplateGroup)

Ajoute l'objet TemplateGroup spécifié à la fin de la collection.Adds the specified TemplateGroup object to the end of the collection.

AddRange(TemplateGroupCollection) AddRange(TemplateGroupCollection) AddRange(TemplateGroupCollection) AddRange(TemplateGroupCollection)

Ajoute les groupes de modèles d'un objet TemplateGroupCollection existant à l'objet TemplateGroupCollection actuel.Adds the template groups in an existing TemplateGroupCollection object to the current TemplateGroupCollection object.

Clear() Clear() Clear() Clear()

Supprime tous les groupes de la collection.Removes all groups from the collection.

Contains(TemplateGroup) Contains(TemplateGroup) Contains(TemplateGroup) Contains(TemplateGroup)

Détermine si le groupe spécifié est contenu dans la collection.Determines whether the specified group is contained within the collection.

CopyTo(TemplateGroup[], Int32) CopyTo(TemplateGroup[], Int32) CopyTo(TemplateGroup[], Int32) CopyTo(TemplateGroup[], Int32)

Copie les groupes dans la collection vers un tableau à une dimension commençant à l'index spécifié du tableau cible.Copies the groups in the collection to a compatible one-dimensional array, starting at the specified index of the target array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(TemplateGroup) IndexOf(TemplateGroup) IndexOf(TemplateGroup) IndexOf(TemplateGroup)

Retourne l'index de l'objet TemplateGroup spécifié dans la collection.Returns the index of the specified TemplateGroup object within the collection.

Insert(Int32, TemplateGroup) Insert(Int32, TemplateGroup) Insert(Int32, TemplateGroup) Insert(Int32, TemplateGroup)

Insère un objet TemplateGroup dans la collection à l'index spécifié.Inserts a TemplateGroup object into the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(TemplateGroup) Remove(TemplateGroup) Remove(TemplateGroup) Remove(TemplateGroup)

Supprime l'objet TemplateGroup spécifié de la collection.Removes the specified TemplateGroup object from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Supprime l'objet TemplateGroup situé à l'index spécifié dans la collection.Removes the TemplateGroup object at the specified index within the collection.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Pour obtenir une description de ce membre, consultez CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Pour obtenir une description de ce membre, consultez Count.For a description of this member, see Count.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Pour obtenir une description de ce membre, consultez IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Pour obtenir une description de ce membre, consultez SyncRoot.For a description of this member, see SyncRoot.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Pour obtenir une description de ce membre, consultez GetEnumerator().For a description of this member, see GetEnumerator().

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Pour obtenir une description de ce membre, consultez Add(Object).For a description of this member, see Add(Object).

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Pour obtenir une description de ce membre, consultez Clear().For a description of this member, see Clear().

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Pour obtenir une description de ce membre, consultez Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Pour obtenir une description de ce membre, consultez IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Pour obtenir une description de ce membre, consultez Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Pour obtenir une description de ce membre, consultez IsFixedSize.For a description of this member, see IsFixedSize.

IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Pour obtenir une description de ce membre, consultez IsReadOnly.For a description of this member, see IsReadOnly.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Pour obtenir une description de ce membre, consultez la classe IList.For a description of this member, see the IList class.

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Pour obtenir une description de ce membre, consultez Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Pour obtenir une description de ce membre, consultez RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Méthodes d’extension

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi