TemplateGroup クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。
デザイン時に Web サーバー コントロールのテンプレート要素を表す TemplateDefinition オブジェクトのコレクション。
名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文
使用例
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Design (system.design.dll 内)
構文使用例ControlDesigner クラスから派生したコントロール デザイナ クラスを作成する方法のコード例を次に示します。このコントロール デザイナは、4 つのテンプレートを使用するコントロールをサポートします。
これを試すには、コードをコンパイルした後、Visual Studio 2005 などのデザイン ホストのデザイン ビューでページを表示します。コントロールを選択し、アクション リストをクリックして変更するテンプレートを選択します。次に、ドラッグ アンド ドロップ機能を使用してコントロールをテンプレート内に移動します。
Imports Microsoft.VisualBasic Imports System Imports System.ComponentModel Imports System.Web.UI Imports System.Web.UI.WebControls Imports System.Web.UI.Design Namespace ASPNet.Design.Samples ' Set an attribute reference to the designer, and define ' the HTML markup that the toolbox will write into the source. <Designer(GetType(TemplateGroupsSampleDesigner)), _ ToolboxData("<{0}:TemplateGroupsSample runat=server></{0}:TemplateGroupsSample>")> _ Public Class TemplateGroupsSample Inherits WebControl Implements INamingContainer ' Field for the templates Private _templates() As ITemplate ' Constructor Public Sub New() ReDim _templates(4) End Sub ' For each template property, set the designer attributes ' so the property does not appear in the property grid, but ' changes to the template are persisted in the control. <Browsable(False), _ PersistenceMode(PersistenceMode.InnerProperty)> _ Public Property Template1() As ITemplate Get Return _templates(0) End Get Set(ByVal Value As ITemplate) _templates(0) = Value End Set End Property <Browsable(False), _ PersistenceMode(PersistenceMode.InnerProperty)> _ Public Property Template2() As ITemplate Get Return _templates(1) End Get Set(ByVal Value As ITemplate) _templates(1) = Value End Set End Property <Browsable(False), _ PersistenceMode(PersistenceMode.InnerProperty)> _ Public Property Template3() As ITemplate Get Return _templates(2) End Get Set(ByVal Value As ITemplate) _templates(2) = Value End Set End Property <Browsable(False), _ PersistenceMode(PersistenceMode.InnerProperty)> _ Public Property Template4() As ITemplate Get Return _templates(3) End Get Set(ByVal Value As ITemplate) _templates(3) = Value End Set End Property Protected Overrides Sub CreateChildControls() ' Instantiate the template inside the panel ' then add the panel to the Controls collection Dim i As Integer For i = 0 To 3 Dim pan As New Panel() _templates(i).InstantiateIn(pan) Me.Controls.Add(pan) Next End Sub End Class ' Designer for the TemplateGroupsSample class Public Class TemplateGroupsSampleDesigner Inherits System.Web.UI.Design.ControlDesigner Private col As TemplateGroupCollection = Nothing Public Overrides Sub Initialize(ByVal Component As IComponent) ' Initialize the base MyBase.Initialize(Component) ' Turn on template editing SetViewFlags(ViewFlags.TemplateEditing, True) End Sub ' Add instructions to the placeholder view of the control Public Overloads Overrides Function GetDesignTimeHtml() As String Return CreatePlaceHolderDesignTimeHtml("Click here and use " & _ "the task menu to edit the templates.") End Function Public Overrides ReadOnly Property TemplateGroups() As TemplateGroupCollection Get If IsNothing(col) Then ' Get the base collection col = MyBase.TemplateGroups ' Create variables Dim tempGroup As TemplateGroup Dim tempDef As TemplateDefinition Dim ctl As TemplateGroupsSample ' Get reference to the component as TemplateGroupsSample ctl = CType(Component, TemplateGroupsSample) ' Create a TemplateGroup tempGroup = New TemplateGroup("Template Set A") ' Create a TemplateDefinition tempDef = New TemplateDefinition(Me, "Template A1", ctl, "Template1", True) ' Add the TemplateDefinition to the TemplateGroup tempGroup.AddTemplateDefinition(tempDef) ' Create another TemplateDefinition tempDef = New TemplateDefinition(Me, "Template A2", ctl, "Template2", True) ' Add the TemplateDefinition to the TemplateGroup tempGroup.AddTemplateDefinition(tempDef) ' Add the TemplateGroup to the TemplateGroupCollection col.Add(tempGroup) ' Create another TemplateGroup and populate it tempGroup = New TemplateGroup("Template Set B") tempDef = New TemplateDefinition(Me, "Template B1", ctl, "Template3", True) tempGroup.AddTemplateDefinition(tempDef) tempDef = New TemplateDefinition(Me, "Template B2", ctl, "Template4", True) tempGroup.AddTemplateDefinition(tempDef) ' Add the TemplateGroup to the TemplateGroupCollection col.Add(tempGroup) End If Return col End Get End Property ' Do not allow direct resizing unless in TemplateMode Public Overrides ReadOnly Property AllowResize() As Boolean Get If Me.InTemplateMode Then Return True Else Return False End If End Get End Property End Class End Namespace <br /><span space="preserve">...</span><br /><%@ Page Language="VB" %> <%@ Register TagPrefix="aspSample" Namespace="ASPNet.Design.Samples" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html > <head runat="server"> <title>Untitled Page</title> </head> <body> <form id="form1" runat="server"> <div> <aspSample:TemplateGroupsSample runat=server ID=TGSample1> </aspSample:TemplateGroupsSample> </div> </form> </body> </html>
using System; using System.ComponentModel; using System.Web.UI; using System.Web.UI.WebControls; using System.Web.UI.Design; namespace ASPNet.Design.Samples { // Set an attribute reference to the designer, and define // the HTML markup that the toolbox will write into the source. [Designer(typeof(TemplateGroupsSampleDesigner)), ToolboxData("<{0}:TemplateGroupsSample runat=server></{0}:TemplateGroupsSample>")] public sealed class TemplateGroupsSample : WebControl, INamingContainer { // Field for the templates private ITemplate[] _templates; // Constructor public TemplateGroupsSample() { _templates = new ITemplate[4]; } // For each template property, set the designer attributes // so the property does not appear in the property grid, but // changes to the template are persisted in the control. [Browsable(false), PersistenceMode(PersistenceMode.InnerProperty)] public ITemplate Template1 { get { return _templates[0]; } set { _templates[0] = value; } } [Browsable(false), PersistenceMode(PersistenceMode.InnerProperty)] public ITemplate Template2 { get { return _templates[1]; } set { _templates[1] = value; } } [Browsable(false), PersistenceMode(PersistenceMode.InnerProperty)] public ITemplate Template3 { get { return _templates[2]; } set { _templates[2] = value; } } [Browsable(false), PersistenceMode(PersistenceMode.InnerProperty)] public ITemplate Template4 { get { return _templates[3]; } set { _templates[3] = value; } } protected override void CreateChildControls() { // Instantiate each template inside a panel // then add the panel to the Controls collection for (int i = 0; i < 4; i++) { Panel pan = new Panel(); _templates[i].InstantiateIn(pan); this.Controls.Add(pan); } } } // Designer for the TemplateGroupsSample control public class TemplateGroupsSampleDesigner : ControlDesigner { TemplateGroupCollection col = null; public override void Initialize(IComponent component) { // Initialize the base base.Initialize(component); // Turn on template editing SetViewFlags(ViewFlags.TemplateEditing, true); } // Add instructions to the placeholder view of the control public override string GetDesignTimeHtml() { return CreatePlaceHolderDesignTimeHtml("Click here and use " + "the task menu to edit the templates."); } public override TemplateGroupCollection TemplateGroups { get { if (col == null) { // Get the base collection col = base.TemplateGroups; // Create variables TemplateGroup tempGroup; TemplateDefinition tempDef; TemplateGroupsSample ctl; // Get reference to the component as TemplateGroupsSample ctl = (TemplateGroupsSample)Component; // Create a TemplateGroup tempGroup = new TemplateGroup("Template Set A"); // Create a TemplateDefinition tempDef = new TemplateDefinition(this, "Template A1", ctl, "Template1", true); // Add the TemplateDefinition to the TemplateGroup tempGroup.AddTemplateDefinition(tempDef); // Create another TemplateDefinition tempDef = new TemplateDefinition(this, "Template A2", ctl, "Template2", true); // Add the TemplateDefinition to the TemplateGroup tempGroup.AddTemplateDefinition(tempDef); // Add the TemplateGroup to the TemplateGroupCollection col.Add(tempGroup); // Create another TemplateGroup and populate it tempGroup = new TemplateGroup("Template Set B"); tempDef = new TemplateDefinition(this, "Template B1", ctl, "Template3", true); tempGroup.AddTemplateDefinition(tempDef); tempDef = new TemplateDefinition(this, "Template B2", ctl, "Template4", true); tempGroup.AddTemplateDefinition(tempDef); // Add the TemplateGroup to the TemplateGroupCollection col.Add(tempGroup); } return col; } } // Do not allow direct resizing unless in TemplateMode public override bool AllowResize { get { if (this.InTemplateMode) return true; else return false; } } } }
継承階層
System.Object
System.Web.UI.Design.TemplateGroup
System.Web.UI.Design.TemplateGroup
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照TemplateGroup コンストラクタ (String, Style)
メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。
指定した名前およびスタイルを使用して、TemplateGroup クラスの新しいインスタンスを作成します。
名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文
パラメータ
.NET Framework のセキュリティ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Design (system.design.dll 内)
構文Dim groupName As String Dim groupStyle As Style Dim instance As New TemplateGroup(groupName, groupStyle)
- groupName
グループの名前。
.NET Framework のセキュリティプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照TemplateGroup コンストラクタ (String)
メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。
指定した名前を使用して、TemplateGroup クラスの新しいインスタンスを作成します。
名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文
.NET Framework のセキュリティ
プラットフォーム
バージョン情報
参照
アセンブリ: System.Design (system.design.dll 内)
構文.NET Framework のセキュリティプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照TemplateGroup コンストラクタ
TemplateGroup クラスの新しいインスタンスを作成します。 TemplateGroups デザイン時サポートの拡張 方法 : デザイン モードでコントロールの外観と動作を拡張する
オーバーロードの一覧
参照
オーバーロードの一覧| 名前 | 説明 |
|---|---|
| TemplateGroup (String) | 指定した名前を使用して、TemplateGroup クラスの新しいインスタンスを作成します。 |
| TemplateGroup (String, Style) | 指定した名前およびスタイルを使用して、TemplateGroup クラスの新しいインスタンスを作成します。 |
参照TemplateGroup プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | GroupName | グループの名前を取得します。 |
| | GroupStyle | グループの現在のスタイルを取得します。 |
| | IsEmpty | グループにテンプレートが存在するかどうかを示す値を取得します。 |
| | Templates | グループのすべてのテンプレート定義の配列を取得します。 |
参照TemplateGroup メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | AddTemplateDefinition | 指定した TemplateDefinition をグループに追加します。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照TemplateGroup メンバ
デザイン時に Web サーバー コントロールのテンプレート要素を表す TemplateDefinition オブジェクトのコレクション。
TemplateGroup データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | GroupName | グループの名前を取得します。 |
| | GroupStyle | グループの現在のスタイルを取得します。 |
| | IsEmpty | グループにテンプレートが存在するかどうかを示す値を取得します。 |
| | Templates | グループのすべてのテンプレート定義の配列を取得します。 |
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
| | AddTemplateDefinition | 指定した TemplateDefinition をグループに追加します。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- TemplateGroupのページへのリンク
