ControlDesigner.Initialize(IComponent) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컨트롤 디자이너를 초기화하고 지정된 구성 요소를 로드합니다.
public:
override void Initialize(System::ComponentModel::IComponent ^ component);
public override void Initialize(System.ComponentModel.IComponent component);
override this.Initialize : System.ComponentModel.IComponent -> unit
Public Overrides Sub Initialize (component As IComponent)
매개 변수
- component
- IComponent
디자인 중인 컨트롤입니다.
예제
다음 코드 예제에서는 컨트롤 클래스 및 내부 변수를 초기화 하는 메서드를 재정의 Initialize 하는 컨트롤 디자이너 클래스를 사용 하는 방법을 보여 줍니다.
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();
}
}
}
}
' Create a designer class for a custom class,
' named Simple.
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
설명
이 Initialize 메서드는 다음 작업을 완료하기 위해 디자인 호스트에서 호출됩니다.
디자인할 구성 요소와 함께 컨트롤 디자이너를 로드합니다.
메서드를 사용하여 SetViewFlags 컨트롤에서 보기를 설정합니다.
연결된 컨트롤이 올바른 형식인지 확인합니다.