TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection Class

Definizione

Rappresenta un insieme di oggetti TemplateGroup in una finestra di progettazione di controlli.Represents a collection of TemplateGroup objects within a control designer. Questa classe non può essere ereditata.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
Ereditarietà
TemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollection
Implementazioni

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come definire una semplice finestra di progettazione di ControlDesigner controlli derivata dalla classe.The following code example demonstrates how to define a simple control designer that is derived from the ControlDesigner class. La finestra di progettazione del controllo TemplateGroups derivato implementa la proprietà ottenendo i gruppi di modelli definiti per la classe base e aggiungendo un gruppo di modelli specifico per la finestra di progettazione del controllo derivato.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

Commenti

La ControlDesigner classe, ed eventuali classi derivate, TemplateGroups definisce la proprietà TemplateGroupCollection come un oggetto.The ControlDesigner class, and any derived class, defines the TemplateGroups property as a TemplateGroupCollection object. La TemplateGroupCollection proprietà viene in genere utilizzata solo da un host di progettazione Visual Studio 2005Visual Studio 2005, ad esempio.The TemplateGroupCollection property is typically used only by a design host such as Visual Studio 2005Visual Studio 2005.

Le dimensioni della raccolta aumentano in modo dinamico man mano che vengono aggiunti oggetti.The collection dynamically increases in size as objects are added. Gli indici in questa raccolta sono in base zero.Indexes in this collection are zero-based. Utilizzare la Count proprietà per determinare il numero di gruppi presenti nella raccolta.Use the Count property to determine how many groups are in the collection.

Usare inoltre i metodi TemplateGroupCollection e le proprietà per fornire le funzionalità seguenti:Additionally, use the TemplateGroupCollection methods and properties to provide the following functionality:

  • Add Metodo per aggiungere un singolo gruppo alla raccolta.The Add method to add a single group to the collection.

  • Insert Metodo per aggiungere un gruppo in corrispondenza di un particolare indice all'interno dell'insieme.The Insert method to add a group at a particular index within the collection.

  • Remove Metodo per rimuovere un gruppo.The Remove method to remove a group.

  • RemoveAt Metodo per rimuovere il gruppo in corrispondenza di un particolare indice.The RemoveAt method to remove the group at a particular index.

  • Contains Metodo per determinare se un particolare gruppo è già presente nella raccolta.The Contains method to determine whether a particular group is already in the collection.

  • IndexOf Metodo per recuperare l'indice di un gruppo all'interno dell'insieme.The IndexOf method to retrieve the index of a group within the collection.

  • Indicizzatore per ottenere o impostare il gruppo in corrispondenza di un particolare indice, usando la Item[Int32] notazione di matrice.The Item[Int32] indexer to get or set the group at a particular index, using array notation.

  • AddRange Metodo per aggiungere più gruppi alla raccolta.The AddRange method to add multiple groups to the collection.

    È possibile aggiungere più gruppi come matrice di gruppi o come TemplateGroupCollection oggetto recuperato tramite la TemplateGroups proprietà di un'altra finestra di progettazione controlli.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 Metodo per rimuovere tutti i gruppi dalla raccolta.The Clear method to remove all groups from the collection.

Costruttori

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

Inizializza una nuova istanza della classe TemplateGroupCollection.Initializes a new instance of the TemplateGroupCollection class.

Proprietà

Count Count Count Count

Ottiene il numero di oggetti TemplateGroup contenuti nell'insieme.Gets the number of TemplateGroup objects in the collection.

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

Ottiene o imposta un oggetto TemplateGroup nella raccolta in corrispondenza dell'indice specificato.Gets or sets a TemplateGroup object at the specified index in the collection.

Metodi

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

Aggiunge l'oggetto TemplateGroup specificato alla fine dell'insieme.Adds the specified TemplateGroup object to the end of the collection.

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

Aggiungere i gruppi di modelli di un oggetto TemplateGroupCollection esistente all'oggetto TemplateGroupCollection corrente.Adds the template groups in an existing TemplateGroupCollection object to the current TemplateGroupCollection object.

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

Rimuove tutti i gruppi dall'insieme.Removes all groups from the collection.

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

Determina se il gruppo specificato è contenuto nell'insieme.Determines whether the specified group is contained within the collection.

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

Copia i gruppi dell'insieme in una matrice compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.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)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce l'indice dell'oggetto TemplateGroup specificato all'interno della raccolta.Returns the index of the specified TemplateGroup object within the collection.

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

Inserisce un oggetto TemplateGroup nell'insieme, in corrispondenza dell'indice specificato.Inserts a TemplateGroup object into the collection at the specified index.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Rimuove l'oggetto TemplateGroup specificato dalla raccolta.Removes the specified TemplateGroup object from the collection.

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

Rimuove l'oggetto TemplateGroup in corrispondenza dell'indice specificato all'interno della raccolta.Removes the TemplateGroup object at the specified index within the collection.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Per una descrizione di questo membro, vedere CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

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

Per una descrizione di questo membro, vedere Count.For a description of this member, see Count.

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

Per una descrizione di questo membro, vedere IsSynchronized.For a description of this member, see IsSynchronized.

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

Per una descrizione di questo membro, vedere SyncRoot.For a description of this member, see SyncRoot.

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

Per una descrizione di questo membro, vedere GetEnumerator().For a description of this member, see GetEnumerator().

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

Per una descrizione di questo membro, vedere Add(Object).For a description of this member, see Add(Object).

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

Per una descrizione di questo membro, vedere Clear().For a description of this member, see Clear().

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

Per una descrizione di questo membro, vedere Contains(Object).For a description of this member, see Contains(Object).

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

Per una descrizione di questo membro, vedere 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)

Per una descrizione di questo membro, vedere Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

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

Per una descrizione di questo membro, vedere IsFixedSize.For a description of this member, see IsFixedSize.

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

Per una descrizione di questo membro, vedere IsReadOnly.For a description of this member, see IsReadOnly.

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

Per una descrizione di questo membro, vedere 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)

Per una descrizione di questo membro, vedere Remove(Object).For a description of this member, see Remove(Object).

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

Per una descrizione di questo membro, vedere RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Metodi di estensione

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

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche