TemplateControl クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TemplateControl クラス

Page クラスと UserControl クラスに、基本の機能セットを提供します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustInherit Class
 TemplateControl
    Inherits Control
    Implements INamingContainer, IFilterResolutionService

Visual Basic (使用法)

Dim instance As TemplateControl

public abstract class TemplateControl : Control,
 INamingContainer, IFilterResolutionService

C++

public ref class TemplateControl abstract :
 public Control, INamingContainer, IFilterResolutionService

public abstract class TemplateControl extends
 Control implements INamingContainer, IFilterResolutionService

JScript

public abstract class TemplateControl extends
 Control implements INamingContainer, IFilterResolutionService

解説

TemplateControl クラスは、Page クラスと UserControl クラスに共通のプロパティとメソッドを提供する抽象クラスです。TemplateControl の新しいインスタンスを直接作成することはできません。

TemplateControl クラスは、宣言によるデータバインディング式をサポートするメソッドを定義します。

単純なプロパティまたは式など、データソースを含むデータバインディング式には Eval メソッドを使用します。
XPath データバインディング式を解析および評価するには XPath メソッドを使用します。
XPath 選択ステートメントを含む式でのデータバインディングに対しては XPathSelect メソッドを使用します。結果は、IEnumerable インターフェイスを実装するノードコレクションになります。

データバインディング式の詳細については、「データバインド式構文」と「データベースへのバインド」を参照してください。

使用例

TemplateControl クラスから MyControl という名前のコントロールを派生させ、Construct メソッドをオーバーライドする方法を次のコード例に示します。MyControl が初期化されると、オーバーライドされた Construct メソッドが呼び出されます。

Visual Basic

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

' The custom user control class.
<AspNetHostingPermission(SecurityAction.Demand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyControl
   Inherits UserControl
   ' Create a Message property and accessors.
   Private _message As String
 = Nothing
   
   Public Property Message() As
 String
      Get
         Return _message
      End Get
      Set
         _message = value
      End Set
   End Property
   
   ' Create an event for this user control and
   ' name it myControl.
   Public Event myControl As
 System.EventHandler
   
   
   ' Override the default constructor.
   Protected Overrides Sub
 Construct()
      ' Specify the handler, MyInit, to be called when the myControl
 event
      ' is raised by the OnInit method.
      AddHandler Me.myControl, AddressOf
 MyInit
   End Sub 'Construct
   
   
   Protected Overrides Sub
 OnInit(e As EventArgs)
      RaiseEvent myControl(Me, e)
      Response.Write("The OnInit() method is used to raise the
 Init event.")
   End Sub 'OnInit
   
   
   ' Use the MyInit handler to set the Message property value
   ' when this method is called.
   Sub MyInit(sender As Object,
 e As System.EventArgs)
      _message = "Hello World!"
   End Sub 'MyInit
   
   ' Write the value of the Message property when the control
   ' is rendered.
   Protected Overrides Sub
 Render(output As HtmlTextWriter)
      output.Write(("<br>Message :" & _message))
   End Sub 'Render
 End Class 'MyControl

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;


 // The custom user control class.
 [AspNetHostingPermission(SecurityAction.Demand, 
   Level=AspNetHostingPermissionLevel.Minimal)]
 public class MyControl:UserControl
 {
   // Create a Message property and accessors.
   private string _message = null;
   public string Message
   {
      get
      {
         return _message;
      }
      set
      {
         _message = value;
      }
   }

   // Create an event for this user control and
   // name it myControl.
   public event System.EventHandler myControl;

   // Override the default constructor.
   protected override void Construct()
   {
      // Specify the handler, MyInit, to be called when the myControl
 event
      // is raised by the OnInit method.
      this.myControl += new System.EventHandler(MyInit);
    
   }

   protected override void OnInit( EventArgs
 e)
   {
      myControl(this ,e);
      Response.Write("The OnInit() method is used to raise the Init event.");
   }

   // Use the MyInit handler to set the Message property value
   // when this method is called.
   void MyInit(object sender,System.EventArgs e)
   {
      _message = "Hello World!";
   }

   // Write the value of the Message property when the control
   // is rendered.
   protected override void Render(HtmlTextWriter
 output) 
   {
      output.Write("<br>Message :" + _message);
   }
 }