TemplateGroupCollection Klasa

Definicja

Reprezentuje kolekcję TemplateGroup obiektów w projektancie kontrolek.Represents a collection of TemplateGroup objects within a control designer. Klasa ta nie może być dziedziczona.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
Dziedziczenie
TemplateGroupCollection
Implementuje

Przykłady

Poniższy przykład kodu ilustruje sposób definiowania prostego projektanta formantów, który jest pochodną ControlDesigner klasy.The following code example demonstrates how to define a simple control designer that is derived from the ControlDesigner class. Pochodny Projektant formantów implementuje TemplateGroups Właściwość przez pobranie grup szablonów, które są zdefiniowane dla klasy bazowej i dodanie grupy szablonów, która jest specyficzna dla projektanta formantów pochodnych.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

Uwagi

ControlDesignerKlasa i jakakolwiek Klasa pochodna definiują TemplateGroups Właściwość jako TemplateGroupCollection obiekt.The ControlDesigner class, and any derived class, defines the TemplateGroups property as a TemplateGroupCollection object. TemplateGroupCollectionWłaściwość jest zazwyczaj używana tylko przez hosta projektowego, takiego jak Visual Studio 2005.The TemplateGroupCollection property is typically used only by a design host such as Visual Studio 2005.

Rozmiar kolekcji jest dynamicznie zwiększany w miarę dodawania obiektów.The collection dynamically increases in size as objects are added. Indeksy w tej kolekcji są oparte na zero.Indexes in this collection are zero-based. Użyj Count właściwości, aby określić, ile grup znajduje się w kolekcji.Use the Count property to determine how many groups are in the collection.

Ponadto należy użyć TemplateGroupCollection metod i właściwości, aby zapewnić następujące funkcje:Additionally, use the TemplateGroupCollection methods and properties to provide the following functionality:

  • AddMetoda dodawania pojedynczej grupy do kolekcji.The Add method to add a single group to the collection.

  • InsertMetoda dodawania grupy w określonym indeksie w kolekcji.The Insert method to add a group at a particular index within the collection.

  • RemoveMetoda usuwania grupy.The Remove method to remove a group.

  • RemoveAtMetoda usuwania grupy w określonym indeksie.The RemoveAt method to remove the group at a particular index.

  • ContainsMetoda służąca do określenia, czy dana grupa znajduje się już w kolekcji.The Contains method to determine whether a particular group is already in the collection.

  • IndexOfMetoda pobierania indeksu grupy w kolekcji.The IndexOf method to retrieve the index of a group within the collection.

  • Item[]Indeksator, aby uzyskać lub ustawić grupę w określonym indeksie przy użyciu notacji tablicy.The Item[] indexer to get or set the group at a particular index, using array notation.

  • AddRangeMetoda dodawania wielu grup do kolekcji.The AddRange method to add multiple groups to the collection.

    Można dodać wiele grup jako tablicę grup lub jako TemplateGroupCollection obiekt pobierany przez TemplateGroups Właściwość innego projektanta formantów.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.

  • ClearMetoda usuwania wszystkich grup z kolekcji.The Clear method to remove all groups from the collection.

Konstruktory

TemplateGroupCollection()

Inicjuje nowe wystąpienie klasy TemplateGroupCollection.Initializes a new instance of the TemplateGroupCollection class.

Właściwości

Count

Pobiera liczbę TemplateGroup obiektów w kolekcji.Gets the number of TemplateGroup objects in the collection.

Item[Int32]

Pobiera lub ustawia TemplateGroup obiekt pod określonym indeksem w kolekcji.Gets or sets a TemplateGroup object at the specified index in the collection.

Metody

Add(TemplateGroup)

Dodaje określony TemplateGroup obiekt na końcu kolekcji.Adds the specified TemplateGroup object to the end of the collection.

AddRange(TemplateGroupCollection)

Dodaje grupy szablonów w istniejącym TemplateGroupCollection obiekcie do bieżącego TemplateGroupCollection obiektu.Adds the template groups in an existing TemplateGroupCollection object to the current TemplateGroupCollection object.

Clear()

Usuwa wszystkie grupy z kolekcji.Removes all groups from the collection.

Contains(TemplateGroup)

Określa, czy określona grupa jest zawarta w kolekcji.Determines whether the specified group is contained within the collection.

CopyTo(TemplateGroup[], Int32)

Kopiuje grupy w kolekcji do zgodnej jednowymiarowej tablicy, rozpoczynając od określonego indeksu tablicy docelowej.Copies the groups in the collection to a compatible one-dimensional array, starting at the specified index of the target array.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(TemplateGroup)

Zwraca indeks określonego TemplateGroup obiektu w kolekcji.Returns the index of the specified TemplateGroup object within the collection.

Insert(Int32, TemplateGroup)

Wstawia TemplateGroup obiekt do kolekcji o określonym indeksie.Inserts a TemplateGroup object into the collection at the specified index.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(TemplateGroup)

Usuwa określony TemplateGroup obiekt z kolekcji.Removes the specified TemplateGroup object from the collection.

RemoveAt(Int32)

Usuwa TemplateGroup obiekt o określonym indeksie w kolekcji.Removes the TemplateGroup object at the specified index within the collection.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz CopyTo(Array, Int32) .For a description of this member, see CopyTo(Array, Int32).

ICollection.Count

Aby uzyskać opis tego elementu członkowskiego, zobacz Count .For a description of this member, see Count.

ICollection.IsSynchronized

Aby uzyskać opis tego elementu członkowskiego, zobacz IsSynchronized .For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Aby uzyskać opis tego elementu członkowskiego, zobacz SyncRoot .For a description of this member, see SyncRoot.

IEnumerable.GetEnumerator()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetEnumerator() .For a description of this member, see GetEnumerator().

IList.Add(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Add(Object) .For a description of this member, see Add(Object).

IList.Clear()

Aby uzyskać opis tego elementu członkowskiego, zobacz Clear() .For a description of this member, see Clear().

IList.Contains(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Contains(Object) .For a description of this member, see Contains(Object).

IList.IndexOf(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz IndexOf(Object) .For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Insert(Int32, Object) .For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

Aby uzyskać opis tego elementu członkowskiego, zobacz IsFixedSize .For a description of this member, see IsFixedSize.

IList.IsReadOnly

Aby uzyskać opis tego elementu członkowskiego, zobacz IsReadOnly .For a description of this member, see IsReadOnly.

IList.Item[Int32]

Aby uzyskać opis tego elementu członkowskiego, zapoznaj się z IList klasą.For a description of this member, see the IList class.

IList.Remove(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz Remove(Object) .For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz RemoveAt(Int32) .For a description of this member, see RemoveAt(Int32).

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też