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 クラスのページへのリンク
