TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection TemplateGroupCollection Class

Definition

Stellt eine Auflistung von TemplateGroup -Objekten in einem Steuerelement-Designer dar.Represents a collection of TemplateGroup objects within a control designer. Diese Klasse kann nicht vererbt werden.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
Vererbung
TemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollectionTemplateGroupCollection
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein einfacher Steuerelement-Designer definiert wird, ControlDesigner der von der-Klasse abgeleitet wird.The following code example demonstrates how to define a simple control designer that is derived from the ControlDesigner class. Der abgeleitete Steuerelement- TemplateGroups Designer implementiert die-Eigenschaft, indem er die Vorlagen Gruppen erhält, die für die Basisklasse definiert sind, und eine für den abgeleiteten Steuerelement-Designer spezifische Vorlagen Gruppe hinzufügen.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

Hinweise

Die ControlDesigner -Klasse und jede abgeleitete Klasse definiert die TemplateGroups -Eigenschaft als TemplateGroupCollection -Objekt.The ControlDesigner class, and any derived class, defines the TemplateGroups property as a TemplateGroupCollection object. Die TemplateGroupCollection -Eigenschaft wird in der Regel nur von einem Entwurfs Host Visual Studio 2005Visual Studio 2005verwendet, z. b.The TemplateGroupCollection property is typically used only by a design host such as Visual Studio 2005Visual Studio 2005.

Die Größe der Auflistung vergrößert sich dynamisch, wenn Objekte hinzugefügt werden.The collection dynamically increases in size as objects are added. Indizes in dieser Sammlung sind NULL basiert.Indexes in this collection are zero-based. Verwenden Sie Count die-Eigenschaft, um zu bestimmen, wie viele Gruppen in der Auflistung sind.Use the Count property to determine how many groups are in the collection.

Verwenden Sie außerdem die TemplateGroupCollection Methoden und Eigenschaften, um die folgenden Funktionen bereitzustellen:Additionally, use the TemplateGroupCollection methods and properties to provide the following functionality:

  • Die Add Methode zum Hinzufügen einer einzelnen Gruppe zur Auflistung.The Add method to add a single group to the collection.

  • Die Insert Methode zum Hinzufügen einer Gruppe an einem bestimmten Index in der Auflistung.The Insert method to add a group at a particular index within the collection.

  • Die Remove Methode zum Entfernen einer Gruppe.The Remove method to remove a group.

  • Die RemoveAt Methode, mit der die Gruppe an einem bestimmten Index entfernt werden soll.The RemoveAt method to remove the group at a particular index.

  • Die Contains Methode, mit der bestimmt wird, ob eine bestimmte Gruppe bereits in der Auflistung vorhanden ist.The Contains method to determine whether a particular group is already in the collection.

  • Die IndexOf Methode, mit der der Index einer Gruppe in der Auflistung abgerufen werden soll.The IndexOf method to retrieve the index of a group within the collection.

  • Der Item[Int32] Indexer, mit dem die Gruppe an einem bestimmten Index mithilfe der Array Notation festgelegt oder festgelegt werden kann.The Item[Int32] indexer to get or set the group at a particular index, using array notation.

  • Die AddRange Methode zum Hinzufügen mehrerer Gruppen zur Auflistung.The AddRange method to add multiple groups to the collection.

    Sie können mehrere Gruppen entweder als Array von Gruppen oder als TemplateGroupCollection -Objekt hinzufügen, das Sie über die TemplateGroups -Eigenschaft eines anderen Steuerelement-Designers abrufen.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.

  • Die Clear -Methode, um alle Gruppen aus der Auflistung zu entfernen.The Clear method to remove all groups from the collection.

Konstruktoren

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

Initialisiert eine neue Instanz der TemplateGroupCollection-Klasse.Initializes a new instance of the TemplateGroupCollection class.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der TemplateGroup-Objekte in der Auflistung ab.Gets the number of TemplateGroup objects in the collection.

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

Ruft ein TemplateGroup-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.Gets or sets a TemplateGroup object at the specified index in the collection.

Methoden

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

Fügt das angegebene TemplateGroup-Objekt am Ende der Auflistung hinzu.Adds the specified TemplateGroup object to the end of the collection.

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

Fügt die Vorlagengruppen in einem vorhandenen TemplateGroupCollection-Objekt dem aktuellen TemplateGroupCollection-Objekt hinzu.Adds the template groups in an existing TemplateGroupCollection object to the current TemplateGroupCollection object.

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

Entfernt alle Gruppen aus der Auflistung.Removes all groups from the collection.

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

Bestimmt, ob die angegebene Gruppe in der Auflistung enthalten ist.Determines whether the specified group is contained within the collection.

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

Kopiert die Gruppen in der Auflistung in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.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)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Gibt den Index des angegebenen TemplateGroup-Objekts in der Auflistung zurück.Returns the index of the specified TemplateGroup object within the collection.

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

Fügt ein TemplateGroup-Objekt am angegebenen Index in die Auflistung ein.Inserts a TemplateGroup object into the collection at the specified index.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Entfernt das angegebene TemplateGroup-Objekt aus der Auflistung.Removes the specified TemplateGroup object from the collection.

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

Entfernt das TemplateGroup-Objekt am angegebenen Index der Auflistung.Removes the TemplateGroup object at the specified index within the collection.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Eine Beschreibung dieses Elements finden Sie unter CopyTo(Array, Int32).For a description of this member, see CopyTo(Array, Int32).

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

Eine Beschreibung dieses Elements finden Sie unter Count.For a description of this member, see Count.

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

Eine Beschreibung dieses Elements finden Sie unter IsSynchronized.For a description of this member, see IsSynchronized.

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

Eine Beschreibung dieses Members finden Sie unter SyncRoot.For a description of this member, see SyncRoot.

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

Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

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

Eine Beschreibung dieses Members finden Sie unter Add(Object).For a description of this member, see Add(Object).

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

Eine Beschreibung dieses Elements finden Sie unter Clear().For a description of this member, see Clear().

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

Eine Beschreibung dieses Elements finden Sie unter Contains(Object).For a description of this member, see Contains(Object).

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

Eine Beschreibung dieses Elements finden Sie unter 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)

Eine Beschreibung dieses Elements finden Sie unter Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

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

Eine Beschreibung dieses Members finden Sie unter IsFixedSize.For a description of this member, see IsFixedSize.

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

Eine Beschreibung dieses Elements finden Sie unter IsReadOnly.For a description of this member, see IsReadOnly.

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

Eine Beschreibung dieses Members finden Sie unter der IList-Klasse.For a description of this member, see the IList class.

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

Eine Beschreibung dieses Elements finden Sie unter Remove(Object).For a description of this member, see Remove(Object).

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

Eine Beschreibung dieses Elements finden Sie unter RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Erweiterungsmethoden

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

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

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

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

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

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

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

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch