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

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

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

HiddenFieldDesigner クラス

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

HiddenField コントロールを、ビジュアルデザイナで、デザイン時に使用できるようにします。

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

Visual Basic (宣言)

Public Class HiddenFieldDesigner
    Inherits ControlDesigner

Visual Basic (使用法)

Dim instance As HiddenFieldDesigner

public class HiddenFieldDesigner : ControlDesigner

C++

public ref class HiddenFieldDesigner : public
 ControlDesigner

public class HiddenFieldDesigner extends ControlDesigner

JScript

public class HiddenFieldDesigner extends
 ControlDesigner

解説

ビジュアルデザイナでユーザーがソースビューからデザインビューに切り替えると、HiddenField コントロールを記述するマークアップのソースコードが解析され、コントロールのデザイン時バージョンがデザインサーフェイスに作成されます。ユーザーが元のソースビューに切り替えると、デザイン時コントロールがマークアップのソースコードに永続化され、Web ページのマークアップに反映されます。HiddenFieldDesigner クラスは、ビジュアルデザイナで HiddenField をデザイン時に使用できるようにします。

GetDesignTimeHtml メソッドは、デザイン時に、関連付けられた HiddenField のレンダリングに使用するマークアップを返します。Initialize メソッドは、関連付けられた HiddenField をデザイナで表示、編集、デザインできるように準備します。

使用例

HiddenFieldDesigner クラスを拡張し、HiddenField コントロールから派生したコントロールの外観をデザイン時に変更するコード例を次に示します。

この例では、MyHiddenField コントロールを HiddenField から派生させています。MyHiddenField は、HiddenField のコピーです。この例では、さらに、HiddenFieldDesigner クラスから MyHiddenFieldDesigner クラスを派生させ、MyHiddenField コントロールの MyHiddenFieldDesigner に DesignerAttribute 属性も適用しています。

MyHiddenFieldDesigner は、GetDesignTimeHtml メソッドをオーバーライドして、プレースホルダを生成します。これには、コントロールクラス名および ID プロパティと Value プロパティが含まれます。

Visual Basic

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

Namespace Examples.VB.WebControls.Design

    ' The MyHiddenField is a copy of the HiddenField.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyHiddenFieldDesigner))>
 _
    Public Class MyHiddenField
        Inherits HiddenField
    End Class ' MyVBHiddenField

    ' Derive a designer that inherits from the HiddenFieldDesigner.
    Public Class MyHiddenFieldDesigner
        Inherits HiddenFieldDesigner

        ' Generate the design-time markup.
        Public Overrides Function
 GetDesignTimeHtml() As String

            ' Get a reference to the control or a copy of the control.
            Dim myHF As MyHiddenField = CType(ViewControl,
 MyHiddenField)

            Dim markup As String
 = _
                CreatePlaceHolderDesignTimeHtml( _
                    "Value: """
 & myHF.Value.ToString() & """"
 )

            Return markup

        End Function ' GetDesignTimeHtml
    End Class ' MyHiddenFieldDesigner
End Namespace ' Examples.VB.WebControls.Design

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

namespace Examples.CS.WebControls.Design
{
    // The MyHiddenField is a copy of the HiddenField.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyHiddenFieldDesigner))]
    public class MyHiddenField : HiddenField
    {
    } // MyHiddenField

    // Derive a designer that inherits from the HiddenFieldDesigner.
    public class MyHiddenFieldDesigner : HiddenFieldDesigner
    {
        // Generate the design-time markup.
        public override string GetDesignTimeHtml()
        {
            // Get a reference to the control or a copy of the control.
            MyHiddenField myHF = (MyHiddenField)ViewControl;

            // Create a placeholder that displays the control value.
            string markup = CreatePlaceHolderDesignTimeHtml(
                 "Value: \"" + myHF.Value.ToString() + "\""
 );

            return markup;

        } // GetDesignTimeHtml
    } // MyHiddenFieldDesigner
} // Examples.CS.WebControls.Design

.NET Framework のセキュリティ

SecurityPermission (アンマネージコードを呼び出すために必要なアクセス許可)。要求値 : Demand。アクセス許可値 : UnmanagedCode。

継承階層

System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
       System.Web.UI.Design.ControlDesigner
        System.Web.UI.Design.WebControls.HiddenFieldDesigner

スレッドセーフ

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

プラットフォーム

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