HideDisabledControlAdapter

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

HideDisabledControlAdapter クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられた Web コントロールに、特定のブラウザに対する既定のマークアップまたは動作を変更するためのレンダリング機能を提供します。

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

Visual Basic (宣言)

Public Class HideDisabledControlAdapter
    Inherits WebControlAdapter

Visual Basic (使用法)

Dim instance As HideDisabledControlAdapter

C#

public class HideDisabledControlAdapter : WebControlAdapter

C++

public ref class HideDisabledControlAdapter
 : public WebControlAdapter

J#

public class HideDisabledControlAdapter extends
 WebControlAdapter

JScript

public class HideDisabledControlAdapter extends
 WebControlAdapter

解説

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 クラスから派生したアダプタ。

• Label コントロールおよびデバイス固有のコンテンツが取り込まれた .aspx ファイル。

• アダプタをデバイスの種類にリンクさせるためのブラウザ ファイル。

HideDisabledControlAdapter クラスを拡張する方法を次のコード例に示します。

Visual Basic

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

C#

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 コントロールを宣言する方法を次のコード例に示します。

Visual Basic

<%@ 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>

C#

<%@ 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 上で実行するブラウザのカスタム アダプタにリンクさせる方法を次のコード例に示します。

Visual Basic

<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>

C#

<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 のセキュリティ

• AspNetHostingPermission  (コンパイル時に、直前の呼び出し元に HideDisabledControlAdapter クラスに対する呼び出しを行うアクセス許可があるかどうかを検査するために必要なアクセス許可)Minimal (関連する列挙体)
• AspNetHostingPermission  (HideDisabledControlAdapter クラスから派生したクラスの信頼レベルが Minimal 以上であることを検査するために必要なアクセス許可) (関連する列挙体) Minimal

継承階層

System.Object
   System.Web.UI.Adapters.ControlAdapter
     System.Web.UI.WebControls.Adapters.WebControlAdapter
      System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HideDisabledControlAdapter メンバ
System.Web.UI.WebControls.Adapters 名前空間
WebControlAdapter
WebControl クラス
AspNetHostingPermission
HttpBrowserCapabilities
その他の技術情報
アダプティブ コントロール動作のアーキテクチャの概要
アダプティブ コントロール動作のアーキテクチャの概要

HideDisabledControlAdapter コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

HideDisabledControlAdapter クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New HideDisabledControlAdapter

C#

public HideDisabledControlAdapter ()

C++

public:
HideDisabledControlAdapter ()

J#

public HideDisabledControlAdapter ()

JScript

public function HideDisabledControlAdapter
 ()

解説

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HideDisabledControlAdapter クラス
HideDisabledControlAdapter メンバ
System.Web.UI.WebControls.Adapters 名前空間
WebControl クラス
WebControlAdapter
Control
Adapter
その他の技術情報
アダプティブ コントロール動作のアーキテクチャの概要

HideDisabledControlAdapter プロパティ

プロテクト プロパティ

	名前	説明
	Browser	現在の HTTP 要求の作成元であるクライアントのブラウザ機能への参照を取得します。 ( ControlAdapter から継承されます。)
	Control	このコントロール アダプタの割り当て先 Web コントロールへの参照を取得します。 ( WebControlAdapter から継承されます。)
	IsEnabled	Web コントロールおよびそのすべての親コントロールが有効になっているかどうかを示す値を取得します。 ( WebControlAdapter から継承されます。)
	Page	このアダプタに関連付けられたコントロールが配置されているページへの参照を取得します。 ( ControlAdapter から継承されます。)
	PageAdapter	関連付けられたコントロールが配置されているページのページ アダプタへの参照を取得します。 ( ControlAdapter から継承されます。)

参照

関連項目

HideDisabledControlAdapter クラス
System.Web.UI.WebControls.Adapters 名前空間
WebControlAdapter
WebControl クラス
AspNetHostingPermission
HttpBrowserCapabilities

その他の技術情報

アダプティブ コントロール動作のアーキテクチャの概要
アダプティブ コントロール動作のアーキテクチャの概要

HideDisabledControlAdapter メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	BeginRender	コントロールの表示前に呼び出されます。派生アダプタ クラスで、HTML ブラウザには必要ではなくても特定のターゲットには必要な開始タグを生成します。 ( ControlAdapter から継承されます。)
	CreateChildControls	複合コントロールのターゲット固有の子コントロールを作成します。 ( ControlAdapter から継承されます。)
	EndRender	コントロールの表示後に呼び出されます。派生アダプタ クラスで、HTML ブラウザには必要ではなくても特定のターゲットには必要な終了タグを生成します。 ( ControlAdapter から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	LoadAdapterControlState	このコントロール アダプタに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterControlState によって保存された、アダプタのコントロール状態情報を読み込みます。 ( ControlAdapter から継承されます。)
	LoadAdapterViewState	このコントロール アダプタに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterViewState によって保存された、アダプタのビューステートを読み込みます。 ( ControlAdapter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnInit	関連付けられたコントロールの OnInit メソッドをオーバーライドします。 ( ControlAdapter から継承されます。)
	OnLoad	関連付けられたコントロールの OnLoad メソッドをオーバーライドします。 ( ControlAdapter から継承されます。)
	OnPreRender	関連付けられたコントロールの OnPreRender メソッドをオーバーライドします。 ( ControlAdapter から継承されます。)
	OnUnload	関連付けられたコントロールの OnUnload メソッドをオーバーライドします。 ( ControlAdapter から継承されます。)
	Render	オーバーライドされます。 関連付けられた Web コントロールを、HTML として出力ストリームに書き込みます。
	RenderBeginTag	対象のブラウザに送信されるマークアップ内に Web コントロールの開始タグを作成します。 ( WebControlAdapter から継承されます。)
	RenderChildren	コントロール アダプタの割り当て先である複合コントロールに含まれる子コントロールのターゲット固有のマークアップを生成します。 ( ControlAdapter から継承されます。)
	RenderContents	コントロール アダプタの割り当て先である Web コントロールのターゲット固有の内部マークアップを生成します。 ( WebControlAdapter から継承されます。)
	RenderEndTag	対象のブラウザに送信されるマークアップ内に Web コントロールの終了タグを作成します。 ( WebControlAdapter から継承されます。)
	SaveAdapterControlState	コントロール アダプタのコントロール状態情報を保存します。 ( ControlAdapter から継承されます。)
	SaveAdapterViewState	コントロール アダプタのビューステート情報を保存します。 ( ControlAdapter から継承されます。)

参照

関連項目

HideDisabledControlAdapter クラス
System.Web.UI.WebControls.Adapters 名前空間
WebControlAdapter
WebControl クラス
AspNetHostingPermission
HttpBrowserCapabilities

その他の技術情報

アダプティブ コントロール動作のアーキテクチャの概要
アダプティブ コントロール動作のアーキテクチャの概要

HideDisabledControlAdapter メンバ

関連付けられた Web コントロールに、特定のブラウザに対する既定のマークアップまたは動作を変更するためのレンダリング機能を提供します。

HideDisabledControlAdapter データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	HideDisabledControlAdapter	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 から継承されます。)

プロテクト メソッド

	名前	説明
	BeginRender	コントロールの表示前に呼び出されます。派生アダプタ クラスで、HTML ブラウザには必要ではなくても特定のターゲットには必要な開始タグを生成します。 (ControlAdapter から継承されます。)
	CreateChildControls	複合コントロールのターゲット固有の子コントロールを作成します。 (ControlAdapter から継承されます。)
	EndRender	コントロールの表示後に呼び出されます。派生アダプタ クラスで、HTML ブラウザには必要ではなくても特定のターゲットには必要な終了タグを生成します。 (ControlAdapter から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	LoadAdapterControlState	このコントロール アダプタに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterControlState によって保存された、アダプタのコントロール状態情報を読み込みます。 (ControlAdapter から継承されます。)
	LoadAdapterViewState	このコントロール アダプタに関連付けられたコントロールが配置されているページに対する以前の要求時に SaveAdapterViewState によって保存された、アダプタのビューステートを読み込みます。 (ControlAdapter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnInit	関連付けられたコントロールの OnInit メソッドをオーバーライドします。 (ControlAdapter から継承されます。)
	OnLoad	関連付けられたコントロールの OnLoad メソッドをオーバーライドします。 (ControlAdapter から継承されます。)
	OnPreRender	関連付けられたコントロールの OnPreRender メソッドをオーバーライドします。 (ControlAdapter から継承されます。)
	OnUnload	関連付けられたコントロールの OnUnload メソッドをオーバーライドします。 (ControlAdapter から継承されます。)
	Render	オーバーライドされます。 関連付けられた Web コントロールを、HTML として出力ストリームに書き込みます。
	RenderBeginTag	対象のブラウザに送信されるマークアップ内に Web コントロールの開始タグを作成します。 (WebControlAdapter から継承されます。)
	RenderChildren	コントロール アダプタの割り当て先である複合コントロールに含まれる子コントロールのターゲット固有のマークアップを生成します。 (ControlAdapter から継承されます。)
	RenderContents	コントロール アダプタの割り当て先である Web コントロールのターゲット固有の内部マークアップを生成します。 (WebControlAdapter から継承されます。)
	RenderEndTag	対象のブラウザに送信されるマークアップ内に Web コントロールの終了タグを作成します。 (WebControlAdapter から継承されます。)
	SaveAdapterControlState	コントロール アダプタのコントロール状態情報を保存します。 (ControlAdapter から継承されます。)
	SaveAdapterViewState	コントロール アダプタのビューステート情報を保存します。 (ControlAdapter から継承されます。)

参照

関連項目

HideDisabledControlAdapter クラス
System.Web.UI.WebControls.Adapters 名前空間
WebControlAdapter
WebControl クラス
AspNetHostingPermission
HttpBrowserCapabilities

その他の技術情報

アダプティブ コントロール動作のアーキテクチャの概要
アダプティブ コントロール動作のアーキテクチャの概要