HideDisabledControlAdapter クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説HideDisabledControlAdapter クラスは、関連付けられた WebControl コントロールを調整し、特定のブラウザに対する既定のマークアップまたは動作を変更します。HideDisabledControlAdapter クラスを拡張することにより、WebControl コントロールの表示をより詳細にカスタマイズできます。
アダプタは、ページまたはコントロールの有効期間中に 1 つ以上の段階を引き継ぐコンパイル済みの .NET Framework コンポーネントです。HideDisabledControlAdapter クラスを拡張すると、WebControl コントロールの有効期間の段階へのアクセスが提供されます。詳細については、「アダプティブ コントロール動作のアーキテクチャの概要」を参照してください。
アダプタの初期要求により、要求側のブラウザの特性に応じて、コントロールに割り当てられたアダプタが .NET Framework によって検索されます。ブラウザ定義ファイルは、HttpBrowserCapabilities クラスで使用され、クライアント ブラウザの特性を識別したり、アダプタをブラウザの種類に対応付けたりします。詳細については、「アダプティブ コントロール動作のアーキテクチャの概要」を参照してください。
適応できる ASP.NET レンダリング アーキテクチャの説明と、コントロール アダプタを実装してコントロールに割り当てる方法を示す詳細な手順については、MSDN ライブラリの「Authoring ASP.NET Server Control Adapters: An Introduction」を参照してください (http://msdn.microsoft.com/library)。
使用例HideDisabledControlAdapter クラスを拡張して、有効および無効な状態で Label コントロールを表示する方法を次のコード例に示します。この例は、3 つの部分で構成されています。
HideDisabledControlAdapter クラスを拡張する方法を次のコード例に示します。
Imports System Imports System.Web Imports System.Web.UI Imports System.Security.Permissions Namespace Contoso <AspNetHostingPermission( _ SecurityAction.Demand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermission( _ SecurityAction.InheritanceDemand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ Public Class HideDisabledControlContosoAdapter Inherits System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter Protected Overloads ReadOnly Property Control() As _ System.Web.UI.WebControls.Label Get Return CType( _ MyBase.Control, _ System.Web.UI.WebControls.Label) End Get End Property ' Do not render the control if Enabled is false. Protected Overrides Sub Render(ByVal writer As HtmlTextWriter) If (Control.ID.StartsWith("Contoso")) Then If (Not Control.Enabled) Then Return End If End If MyBase.Render(writer) End Sub End Class End Namespace
using System; using System.Web; using System.Web.UI; using System.Security.Permissions; namespace Contoso { [AspNetHostingPermission( SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermission( SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)] public class HideDisabledControlContosoAdapter: System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter { // Link the Label control to the adapter. protected new System.Web.UI.WebControls.Label Control { get { return (System.Web.UI.WebControls.Label)base.Control; } } // Do not render the Contoso controls if Enabled is false. protected override void Render(System.Web.UI.HtmlTextWriter writer) { if (Control.ID.StartsWith("Contoso")) { if (!Control.Enabled) { return; } } base.Render(writer); } } }
デバイス固有のコンテンツで Label コントロールを宣言する方法を次のコード例に示します。
<%@ page language="VB" %> <html> <head id="Head1" runat="server"> <title>HideDisabledControl Adapter</title> <script runat="server"> Sub ServerButtonClick(ByVal source As Object, ByVal args As EventArgs) If (Button1.Text.Equals("Enable Label")) Then ContosoLabel1.Enabled = True Button1.Text = "Disable Label" messageLabel.Text = "The label is <b>En</b>abled" Else ContosoLabel1.Enabled = False Button1.Text = "Enable Label" messageLabel.Text = "The label is <b>dis</b>abled" End If End Sub </script> </head> <body bgcolor=silver> <form id="Form1" runat="server"> <asp:Label id="ContosoLabel1" text="Contoso Label" WinCE:text="CE Label" BorderWidth="3" BorderStyle="Inset" style="FONT-SIZE: xx-small" runat="server"> </asp:Label> <br /> <asp:Button id="Button1" text="Disable Label" OnClick="ServerButtonClick" runat="server" /> <br /> <asp:Label id="messageLabel" runat="server" style="FONT-SIZE: xx-small"> <I>Select the button to disable the label.</I> </asp:Label> </form> </body> </html>
<%@ page language="C#" %> <html> <head id="Head1" runat="server"> <title>HideDisabledControl Adapter</title> <script runat="server"> void ServerButtonClick(Object source, EventArgs args) { if (Button1.Text == "Enable Label") { ContosoLabel1.Enabled = true; Button1.Text = "Disable Label"; messageLabel.Text = "The label is <b>En</b>abled"; } else { ContosoLabel1.Enabled = false; Button1.Text = "Enable Label"; messageLabel.Text = "The label is <b>dis</b>abled"; } } </script> </head> <body bgcolor=silver> <form id="Form1" runat="server"> <asp:Label id="ContosoLabel1" text="Contoso Label" WinCE:text="CE Label" BorderWidth="3" BorderStyle="Inset" style="FONT-SIZE: xx-small" runat="server"> </asp:Label> <br /> <asp:Button id="Button1" text="Disable Label" OnClick="ServerButtonClick" runat="server" /> <br /> <asp:Label id="messageLabel" runat="server" style="FONT-SIZE: xx-small"> <I>Select the button to disable the label.</I> </asp:Label> </form> </body> </html>
Label コントロールを、Windows CE .NET 上で実行するブラウザのカスタム アダプタにリンクさせる方法を次のコード例に示します。
<browsers>
<browser refID="WinCE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter"
/>
</controlAdapters>
</browser>
<browser refID="IE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter"
/>
</controlAdapters>
</browser>
</browsers>
<browsers>
<browser refID="WinCE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter"
/>
</controlAdapters>
</browser>
<browser refID="IE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter"
/>
</controlAdapters>
</browser>
</browsers>
.NET Framework のセキュリティ継承階層System.Web.UI.Adapters.ControlAdapter
System.Web.UI.WebControls.Adapters.WebControlAdapter
System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照HideDisabledControlAdapter コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文解説HideDisabledControlAdapter クラスのインスタンスは、.NET Framework によって生成されます。アダプタの初期要求により、要求側のブラウザの特性に応じて、コントロールに割り当てられたアダプタが .NET Framework によって検索されます。見つかった場合、コントロールの Adapter プロパティには、割り当てられたアダプタ インスタンスへの参照が格納されます。アダプタの割り当てとブラウザ定義ファイルの詳細については、「アダプティブ コントロール動作のアーキテクチャの概要」を参照してください。
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照HideDisabledControlAdapter プロパティ
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | Browser | 現在の HTTP 要求の作成元であるクライアントのブラウザ機能への参照を取得します。 ( ControlAdapter から継承されます。) |
| | Control | このコントロール アダプタの割り当て先 Web コントロールへの参照を取得します。 ( WebControlAdapter から継承されます。) |
| | IsEnabled | Web コントロールおよびそのすべての親コントロールが有効になっているかどうかを示す値を取得します。 ( WebControlAdapter から継承されます。) |
| | Page | このアダプタに関連付けられたコントロールが配置されているページへの参照を取得します。 ( ControlAdapter から継承されます。) |
| | PageAdapter | 関連付けられたコントロールが配置されているページのページ アダプタへの参照を取得します。 ( ControlAdapter から継承されます。) |
参照HideDisabledControlAdapter メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド.gif)
参照HideDisabledControlAdapter メンバ
関連付けられた Web コントロールに、特定のブラウザに対する既定のマークアップまたは動作を変更するためのレンダリング機能を提供します。
HideDisabledControlAdapter データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタプロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
| | Browser | 現在の HTTP 要求の作成元であるクライアントのブラウザ機能への参照を取得します。(ControlAdapter から継承されます。) |
| | Control | このコントロール アダプタの割り当て先 Web コントロールへの参照を取得します。(WebControlAdapter から継承されます。) |
| | IsEnabled | Web コントロールおよびそのすべての親コントロールが有効になっているかどうかを示す値を取得します。(WebControlAdapter から継承されます。) |
| | Page | このアダプタに関連付けられたコントロールが配置されているページへの参照を取得します。(ControlAdapter から継承されます。) |
| | PageAdapter | 関連付けられたコントロールが配置されているページのページ アダプタへの参照を取得します。(ControlAdapter から継承されます。) |
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド参照Weblioに収録されているすべての辞書からHideDisabledControlAdapterを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からHideDisabledControlAdapter
を検索
- HideDisabledControlAdapterのページへのリンク
