WebControl イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照関連項目
WebControl クラスSystem.Web.UI.WebControls 名前空間
WebControl.BackColor プロパティ
WebControl.ForeColor プロパティ
WebControl.BorderWidth プロパティ
WebControl.BorderStyle プロパティ
WebControl.BorderColor プロパティ
WebControl.Height プロパティ
WebControl.Width プロパティ
WebControl.Enabled プロパティ
WebControl.TabIndex プロパティ
WebControl.ToolTip プロパティ
その他の技術情報
ASP.NET Web サーバー コントロールとブラウザの機能ASP.NET カスタム サーバー コントロールの開発
Web サーバー コントロール構文
ASP.NET のテーマとスキン
ASP.NET カスタム サーバー コントロールの開発
WebControl クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説WebControl クラスには、すべての Web サーバー コントロールに共通するプロパティ、メソッド、およびイベントが用意されています。このクラスで定義されたプロパティを設定することによって、Web サーバー コントロールの外観と動作を制御できます。たとえば、コントロールの背景色とフォントの色を制御するには、BackColor プロパティと ForeColor プロパティをそれぞれ設定します。境界線を表示できるコントロールで、境界線の幅、境界線スタイル、および境界線の色を制御するには、BorderWidth、BorderStyle、BorderColor の各プロパティをそれぞれ設定します。Web サーバー コントロールのサイズを指定するには、Height プロパティと Width プロパティを使用します。
コントロールの動作は、特定のプロパティを設定して指定できます。コントロールを有効または無効にするには、Enabled プロパティを設定します。タブ オーダーのコントロールの位置を制御するには、TabIndex プロパティを設定します。コントロールのツールヒントを指定するには、ToolTip プロパティを設定します。
.gif) メモ |
|---|
| このクラスで定義されるプロパティを一部しかサポートしないコントロールもあります。プロパティがサポートされるかどうかについては、特定のコントロールに関するドキュメントを参照してください。 |
| メモ |
|---|
| このクラスのプロパティの中には、ブラウザによって表示方法が異なるプロパティがあります。まったく表示されないプロパティもあれば、表示には影響を与えないプロパティもあります。HttpBrowserCapabilities オブジェクトの TagWriter プロパティによって、Web サーバー コントロールでの表示方法を決定します。HTML 4.0 をサポートするブラウザの場合、TagWriter プロパティは通常の HttpBrowserCapabilities オブジェクトを示し、ほとんどのプロパティは HTML 4.0 スタイル属性を使用して表示されます。HTML 4.0 をサポートすることが認識されないブラウザは、Html32TextWriter オブジェクトを使用します。これによって、スタイル属性は、関連の HTML 3.2 タグ属性に自動的に変換されます。ForeColor プロパティを使用した場合などに、スタイル属性が、<font> タグなどの追加のタグに変換される場合があります。また、マップが実行されない場合もあります。プロパティを各種ブラウザに表示する方法については、特定のプロパティに関するドキュメントを参照してください。 |
WebControl のインスタンスの初期プロパティ値の一覧については、WebControl コンストラクタのトピックを参照してください。
使用例Imports System Imports System.Web.UI Imports System.Web.UI.WebControls Namespace ControlTest ' Renders the following HTML: ' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span> Public Class MyWebControl Inherits WebControl Public Sub New() MyBase.New(HtmlTextWriterTag.Span) End Sub 'New <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter) writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');") writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red") MyBase.AddAttributesToRender(writer) End Sub 'AddAttributesToRender <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Protected Overrides Sub RenderContents(writer As HtmlTextWriter) writer.Write("Custom Contents") MyBase.RenderContents(writer) End Sub 'RenderContents End Class 'MyWebControl End Namespace 'ControlTest
namespace ControlTest { using System; using System.Web.UI; using System.Web.UI.WebControls; // Renders the following HTML: // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span> public class MyWebControl: WebControl { public MyWebControl() : base(HtmlTextWriterTag.Span) { } [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void AddAttributesToRender(HtmlTextWriter writer) { writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');"); writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red"); base.AddAttributesToRender(writer); } [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void RenderContents(HtmlTextWriter writer) { writer.Write("Custom Contents"); base.RenderContents(writer); } } }
package ControlTest; import System.*; import System.Web.UI.*; import System.Web.UI.WebControls.*; // Renders the following HTML: // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span> public class MyWebControl extends WebControl { public MyWebControl() { super(HtmlTextWriterTag.Span); } //MyWebControl protected void AddAttributesToRender(HtmlTextWriter writer) { writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');"); writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red"); super.AddAttributesToRender(writer); } //AddAttributesToRender /** @attribute System.Security.Permissions.PermissionSet(System.Security. Permissions.SecurityAction.Demand, Name = "FullTrust") */ protected void RenderContents(HtmlTextWriter writer) { writer.Write("Custom Contents"); super.RenderContents(writer); } //RenderContents } //MyWebControl
.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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebControl コンストラクタ ()
アセンブリ: System.Web (system.web.dll 内)
構文解説このコンストラクタは、Span HTML 要素を表す WebControl クラスの新しいインスタンスを初期化するために使用します。
WebControl のインスタンスの初期プロパティ値を次の表に示します。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebControl コンストラクタ (HtmlTextWriterTag)
アセンブリ: System.Web (system.web.dll 内)
構文解説このコンストラクタを使用して、指定した System.Web.UI.HtmlTextWriterTag 値で、WebControl クラスの新しいインスタンスを作成し、初期化します。
WebControl のインスタンスの初期プロパティ値を次の表に示します。
使用例WebControl クラスのコンストラクタを使用して、TextArea HTML 要素を作成し、それを Web フォーム ページに表示する方法の例を次に示します。
| メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Button1_Click(sender As Object, e As EventArgs) Dim wc As New WebControl(HtmlTextWriterTag.Textarea) PlaceHolder1.Controls.Add(wc) End Sub </script> </head> <body> <form runat="server"> <h3>WebControl Constructor Example</h3> <p> <asp:PlaceHolder id="PlaceHolder1" runat="Server"/> <br> <asp:Button id="Button1" Text="Click to create a new TextArea" OnClick="Button1_Click" runat="Server" /> <p> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Button1_Click(Object sender, EventArgs e) { WebControl wc = new WebControl(HtmlTextWriterTag.Textarea); PlaceHolder1.Controls.Add(wc); } </script> </head> <body> <form runat="server"> <h3>WebControl Constructor Example</h3> <p> <asp:PlaceHolder id="PlaceHolder1" runat="Server"/> <br> <asp:Button id="Button1" Text="Click to create a new TextArea" OnClick="Button1_Click" runat="Server" /> <p> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script runat="server"> function Button1_Click(sender : Object, e : EventArgs){ var wc : WebControl = new WebControl(HtmlTextWriterTag.Textarea) PlaceHolder1.Controls.Add(wc) } </script> </head> <body> <form runat="server"> <h3>WebControl Constructor Example</h3> <p> <asp:PlaceHolder id="PlaceHolder1" runat="Server"/> <br> <asp:Button id="Button1" Text="Click to create a new TextArea" OnClick="Button1_Click" runat="Server" /> <p> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebControl コンストラクタ
オーバーロードの一覧| 名前 | 説明 |
|---|---|
| WebControl () | Span HTML タグを表す WebControl クラスの新しいインスタンスを初期化します。 |
| WebControl (HtmlTextWriterTag) | 指定した HTML タグを使用して、WebControl クラスの新しいインスタンスを初期化します。 |
| WebControl (String) | 指定した HTML タグを使用して、WebControl クラスの新しいインスタンスを初期化します。 |
参照関連項目
WebControl クラスWebControl メンバ
System.Web.UI.WebControls 名前空間
HtmlTextWriterTag
TagKey
その他の技術情報
Web サーバー コントロール構文ASP.NET カスタム サーバー コントロールの開発
WebControl コンストラクタ (String)
アセンブリ: System.Web (system.web.dll 内)
構文解説このコンストラクタを使用して、指定した HTML タグで WebControl クラスの新しいインスタンスを作成し、初期化します。
WebControl のインスタンスの初期プロパティ値を次の表に示します。
| メモ |
|---|
| このコンストラクタは直接には呼び出されません。通常は、直接呼び出される代わりに、派生クラスのコンストラクタによって呼び出され、TagKey プロパティと TagName プロパティを初期化します。 |
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebControl プロパティ
パブリック プロパティ.gif)
プロテクト プロパティ.gif)
参照WebControl メソッド
パブリック メソッド.gif)
プロテクト メソッド.gif)
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
.gif) | System.Web.UI.IAttributeAccessor.GetAttribute | 指定された名前の Web コントロールの属性を取得します。 |
| | System.Web.UI.IAttributeAccessor.SetAttribute | Web コントロールの属性を指定された名前と値に設定します。 |
参照WebControl メンバ
System.Web.UI.WebControls 名前空間のすべてのコントロールに共通のメソッド、プロパティおよびイベントを定義する基本クラスとして機能します。
WebControl データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタプロテクト コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
明示的インターフェイスの実装| 名前 | 説明 | |
|---|---|---|
| | System.Web.UI.IAttributeAccessor.GetAttribute | 指定された名前の Web コントロールの属性を取得します。 |
| | System.Web.UI.IAttributeAccessor.SetAttribute | Web コントロールの属性を指定された名前と値に設定します。 |
参照- WebControlのページへのリンク
