TemplateGroupCollection クラス

定義

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

継承

Object

TemplateGroupCollection

実装

ICollection IEnumerable IList

例

次のコード例では、 クラスから派生した単純なコントロール デザイナーを定義する方法を ControlDesigner 示します。 派生コントロール デザイナーは、基本クラスに TemplateGroups 対して定義されているテンプレート グループを取得し、派生コントロール デザイナーに固有のテンプレート グループを追加することによって、 プロパティを実装します。

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

注釈

クラスと派生クラスは ControlDesigner 、 プロパティを TemplateGroups オブジェクトとして TemplateGroupCollection 定義します。 プロパティは TemplateGroupCollection 通常、Visual Studio 2005 などのデザイン ホストでのみ使用されます。

オブジェクトが追加されると、コレクションのサイズが動的に増加します。 このコレクション内のインデックスは 0 から始まります。 コレクション内の Count グループの数を確認するには、 プロパティを使用します。

さらに、 メソッドとプロパティを TemplateGroupCollection 使用して、次の機能を提供します。

• Addコレクションに 1 つのグループを追加するメソッド。

• コレクション内の Insert 特定のインデックスにグループを追加するメソッド。

• Removeグループを削除するメソッド。

• 特定の RemoveAt インデックスにあるグループを削除するメソッド。

• 特定の Contains グループが既にコレクション内にあるかどうかを判断するメソッド。

• IndexOfコレクション内のグループのインデックスを取得するメソッド。

• Item[]配列表記を使用して、特定のインデックスでグループを取得または設定するインデクサー。

• AddRangeコレクションに複数のグループを追加するメソッド。

  グループの配列として、または別のコントロール デザイナーの プロパティを TemplateGroupCollection 使用して取得するオブジェクトとして、複数のグループを TemplateGroups 追加できます。

• Clearコレクションからすべてのグループを削除するメソッド。

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

こちらもご覧ください

• TemplateGroups
• TemplateGroup
• TemplateDefinition
• ASP.NET コントロール デザイナーの概要
• デザイン時サポートの拡張
• 方法 : デザイン モードでコントロールの外観と動作を拡張する