ControlDesigner.Initialize メソッド

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

ControlDesigner.Initialize メソッド

コントロール デザイナを初期化し、指定されたコンポーネントを読み込みます。

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

Visual Basic (宣言)

Public Overrides Sub Initialize
 ( _
    component As IComponent _
)

Visual Basic (使用法)

Dim instance As ControlDesigner
Dim component As IComponent

instance.Initialize(component)

C#

public override void Initialize (
    IComponent component
)

C++

public:
virtual void Initialize (
    IComponent^ component
) override

J#

public void Initialize (
    IComponent component
)

JScript

public override function Initialize (
    component : IComponent
)

パラメータ

component

デザインの対象となるコントロール。

解説

Initialize メソッドは、次のアクションを実行するためにデザイン ホストによって呼び出されます。

• デザインするコンポーネントをコントロール デザイナに読み込む。

• SetViewFlags メソッドを使用してコントロールにビューを設定する。

• 関連付けられているコントロールの種類が正しいことを検査する。

使用例

Initialize メソッドをオーバーライドするコントロール クラスおよびコントロール デザイナ クラスを使用して、内部変数を初期化する方法のコード例を次に示します。

Visual Basic

' Create a designer class for a custom class,
' named Simple.
Imports System
Imports System.ComponentModel
Imports System.IO
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports AspNet.Samples

Namespace AspNet.Samples

   Public NotInheritable Class
 SimpleDesigner
      Inherits System.Web.UI.Design.ControlDesigner
      ' Declare a reference to the Simple class
      Private simpleControl As Simple
  
      ' Create a constructor for the designer class
      ' When an instance of the designer is created,
      ' the Text property of the instance of a Simple control
      ' is set to the designer's ID property.
      ' the designer is called.
      Public Sub New()
        simpleControl = CType(Component, Simple)      
        simpleControl.Text = Me.ID
      End Sub

      ' Override the Initialize method to ensure
      ' that the designer is always working with
      ' an instance of the Simple class.
      Overrides Public Sub
 Initialize( _
       ByVal component As IComponent _
      )
      
        If Not (component Is
 simpleControl)
                throw new ArgumentException(
 _
                 "The component must be an instance of the Simple
 class.", _
                 "component")
        End If

        MyBase.Initialize(component)
      
      End Sub
      
      Overrides Public ReadOnly
 Property AllowResize As Boolean
        Get
          Return True
        End Get
      End Property
      
      Public Overrides Function
 GetDesignTimeHtml() As String
         ' Component is the instance of the component or control that
         ' this designer object is associated with. This property is
 
         ' inherited from System.ComponentModel.ComponentDesigner.
         simpleControl = CType(Component, Simple)
         
         If simpleControl.Text.Length > 0 Then
            Dim sw As New
 StringWriter()
            Dim tw As New
 HtmlTextWriter(sw)
            
            Dim placeholderLink As New
 HyperLink()
            
            ' Put simpleControl.Text into the link's Text.
            placeholderLink.Text = simpleControl.Text
            placeholderLink.NavigateUrl = simpleControl.Text
            placeholderLink.RenderControl(tw)
            
            Return sw.ToString()
         Else
            Return GetEmptyDesignTimeHtml()
         End If
      End Function

      ' Override the OnControlResize method to
      ' set the IsDirty property to true and
      ' call the UpdateDesignTimeHtml method.      
      Overrides Protected Sub
 OnControlResize()
        Me.IsDirty = True
        Me.UpdateDesignTimeHtml
      End Sub
      
   End Class
End Namespace

C#

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

namespace AspNet.Samples
{
    // Create a custom class to render the Text property
    [Designer(typeof(SimpleDesigner)), DefaultProperty("Text"), 
    ToolboxData("<{0}:Simple runat=\"server\"></{0}:Simple>")]
    public sealed class Simple : WebControl
    {
        public Simple()
        { }

        // Create a Text property
        [Browsable(true), Bindable(true), 
            PersistenceMode(PersistenceMode.Attribute)]
        public string Text
        {
            get
            {
                object o = ViewState["TextProp"];
                return (o == null) ? "Sample
 Text" : (string)o;
            }
            set { ViewState["TextProp"] = value; }
        }

        // Render the text inside the control
        protected override void RenderContents(HtmlTextWriter
 writer)
        {
            writer.Write(Text);
        }
    }
}

namespace AspNet.Samples
{
    //Create a designer class for the Simple control
    public sealed class SimpleDesigner : ControlDesigner
    {
        // Declare a reference to the Simple class
        private Simple simpleControl;

        public SimpleDesigner()
        { }

        public override void Initialize(IComponent
 ponent)
        {
            base.Initialize(ponent);

            // Get a reference to the control
            simpleControl = (Simple)ponent;

            //Set Text to the control's ID
            simpleControl.Text = simpleControl.ID;
        }

        // Allow resizing the control in the design host
        public override bool AllowResize
        {
            get
            {
                return true;
            }
        }

        public override string GetDesignTimeHtml()
        {
            if (simpleControl.Text.Length > 0)
            {
                string spec = "<a href='{0}.aspx'>{0}</a>";
                return String.Format(spec, simpleControl.Text);
            }
            else
                return GetEmptyDesignTimeHtml();
        }
    }
}

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

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
IDesigner
その他の技術情報
Web フォームのデザイン時サポート

ControlDesigner.Initialize メソッド

コンポーネントを指定して、デザイナを初期化します。

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

Visual Basic (宣言)

Public Overrides Sub Initialize
 ( _
    component As IComponent _
)

Visual Basic (使用法)

Dim instance As ControlDesigner
Dim component As IComponent

instance.Initialize(component)

C#

public override void Initialize (
    IComponent component
)

C++

public:
virtual void Initialize (
    IComponent^ component
) override

J#

public void Initialize (
    IComponent component
)

JScript

public override function Initialize (
    component : IComponent
)

パラメータ

component

デザイナを関連付ける対象の IComponent。このコンポーネントは、常に、Control のインスタンスであるか、そこから派生している必要があります。

解説

このメソッドは、デザイナを初期化するためにデザイナ ホストによって呼び出されます。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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、1.1、1.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Windows.Forms.Design 名前空間
IDesigner