ControlDesigner.ViewControl 속성

정의

네임스페이스:

System.Web.UI.Design

어셈블리:

System.Design.dll

디자인 타임 HTML 태그를 미리 보는 데 사용할 수 있는 웹 서버 컨트롤을 가져오거나 설정합니다.

public:
 property System::Web::UI::Control ^ ViewControl { System::Web::UI::Control ^ get(); void set(System::Web::UI::Control ^ value); };

public System.Web.UI.Control ViewControl { get; set; }

member this.ViewControl : System.Web.UI.Control with get, set

Public Property ViewControl As Control

속성 값

Control

기본 클래스에서 디자인 타임 HTML 태그를 생성하는 데 사용되는 Control 개체입니다.

예제

다음 코드 예제에서는 컨트롤 디자이너를 표시 하는 방법에 설명 합니다 SupportsPreviewControlAttribute 특성입니다. 이 코드 예제에서는 클래스에서 웹 서버 컨트롤을 Label 파생하고 컨트롤을 사용자 지정 컨트롤 디자이너 구현과 연결합니다. 컨트롤 디자이너 클래스 선언으로 표시 되는 SupportsPreviewControl 특성이 설정 true합니다. 컨트롤 디자이너 재정의 GetDesignTimeHtml 합니다 메서드를 디자인 타임에 기울임꼴로 컨트롤의 속성을 표시 Text 합니다.

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

namespace ControlDesignerSamples.CS
{
    // Define a simple designer associated with a 
    // simple text web control.
    
    // Mark the designer with the SupportsPreviewControlAttribute set
    // to true.  This means the base.UsePreviewControl returns true,
    // and base.ViewControl returns a temporary preview copy of the control.
    [SupportsPreviewControl(true)]
    public class SimpleTextControlDesigner : TextControlDesigner
    {		
        // Override the base GetDesignTimeHtml method to display 
        // the design time text in italics.
        public override string GetDesignTimeHtml()
        {
            string html = String.Empty;
 
            try
            {
                // Initialize the return string to the default
                // design time html of the base TextControlDesigner.
                html = base.GetDesignTimeHtml();

                // Get the ViewControl for the associated control.
                Label ctrl = (Label)ViewControl;

                ctrl.Style.Add(HtmlTextWriterStyle.FontStyle, "Italic");
                html = base.GetDesignTimeHtml();
            }
            catch (System.Exception e)
            {
               if (String.IsNullOrEmpty(html))
               {
                   html = GetErrorDesignTimeHtml(e);
               }
            }
            
            return html;
        }
    }

    // Derive a simple Web control from Label to render a text string.
    // Associate this control with the SimpleTextControlDesigner.
    [DesignerAttribute("ControlDesignerSamples.CS.SimpleTextControlDesigner"),
    ToolboxData("<{0}:MyLabelControl Runat=\"Server\"><{0}:MyLabelControl>")]
    public class MyLabelControl : Label
    {
        // Use the Label control implementation, but associate
        // the derived class with the custom control designer.
    }
}

Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Imports System.Reflection

Namespace ControlDesignerSamples.VB

    ' Derive a simple Web control from Label to render a text string.
    ' Associate this control with the SimpleTextControlDesigner.
    <DesignerAttribute("ControlDesignerSamples.CS.SimpleTextControlDesigner"), _
    ToolboxData("<{0}:MyLabelControl Runat=""Server""><{0}:MyLabelControl>")> _
    Public Class MyLabelControl
        Inherits Label

        ' Use the Label control implementation, but associate
        ' the derived class with the custom control designer.
    End Class


    ' Mark the designer with the SupportsPreviewControlAttribute set
    ' to true.  This means the base.UsePreviewControl returns true,
    ' and base.ViewControl returns a temporary preview copy of the control.
    <SupportsPreviewControl(True)> _
    Public Class SimpleTextControlDesigner
        Inherits TextControlDesigner

        ' Override the base GetDesignTimeHtml method to display 
        ' the design time text in italics.
        Public Overrides Function GetDesignTimeHtml() As String
            Dim html As String = String.Empty

            Try
                ' Get the ViewControl for the associated control.
                Dim ctrl As Label = CType(ViewControl, Label)

                ' Set the default text, if necessary
                If ctrl.Text.Length = 0 Then
                    ctrl.Text = "Sample Text"
                End If

                ' Set the style to italic
                ctrl.Style.Add(HtmlTextWriterStyle.FontStyle, "italic")

                ' Let the base class create the HTML markup
                html = MyBase.GetDesignTimeHtml()
            Catch ex As Exception
                If String.IsNullOrEmpty(html) Then
                    ' Display the exception message
                    html = GetErrorDesignTimeHtml(ex)
                End If
            End Try

            Return html
        End Function

    End Class
End Namespace

설명

속성은 ViewControlUsePreviewControl 속성을 사용하여 반환 값을 결정합니다.

속성이 이 UsePreviewControltrue면 속성은 ViewControl 컨트롤의 임시 복사본을 반환합니다. 임시 컨트롤에 변경 내용이 유지 되지 않습니다.

속성이 이 UsePreviewControlfalse면 속성은 ViewControl 컨트롤에 대한 속성의 Component 인스턴스를 반환합니다. 컨트롤 인스턴스에 대한 변경 내용은 유지됩니다.

SupportsPreviewControl 의 설정은 SupportsPreviewControlAttribute 개체의 값을 UsePreviewControl 설정 하는 데 사용 되는 속성입니다. 따라서 설정은 SupportsPreviewControl 기본 ControlDesigner 클래스의 속성에 의해 ViewControl 반환되는 컨트롤의 형식을 결정합니다. SupportsPreviewControlAttribute 가 컨트롤 디자이너 선언 ControlDesigner 에 지정되지 않은 경우 개체 동작은 속성을 로 false지정하는 SupportsPreviewControl 것과 같습니다.

추가 정보

• SupportsPreviewControlAttribute
• UsePreviewControl
• GetViewRendering
• PreviewControlDesigner
• ASP.NET 컨트롤 디자이너 개요