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

Control Объект, используемый базовым классом для создания разметки HTML во время разработки.

Примеры

В следующем примере кода показано, как пометить конструктор элементов управления атрибутом SupportsPreviewControlAttribute . Пример кода является производным веб-серверным элементом управления от Label класса и связывает элемент управления с реализацией пользовательского конструктора элементов управления. Объявление класса конструктора элементов управления помечается атрибутом, равным SupportsPreviewControltrue. Конструктор элементов управления переопределяет 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

Комментарии

Свойство ViewControl использует UsePreviewControl свойство для определения возвращаемого значения.

UsePreviewControl Если свойство имеет значениеtrue, ViewControl свойство возвращает временную копию элемента управления. Изменения во временном элементе управления не сохраняются.

UsePreviewControl Если свойство имеет значениеfalse, ViewControl свойство возвращает экземпляр Component свойства для элемента управления. Сохраняются изменения экземпляра элемента управления.

Параметр SupportsPreviewControl в SupportsPreviewControlAttribute объекте используется для задания значения UsePreviewControl свойства. SupportsPreviewControl Поэтому параметр определяет тип элемента управления, возвращаемого свойством ViewControl в базовом ControlDesigner классе. SupportsPreviewControlAttribute Если объект не указан в объявлении конструктора элементов управления, ControlDesigner поведение объекта эквивалентно указанию SupportsPreviewControl свойства как false.

См. также раздел

• SupportsPreviewControlAttribute
• UsePreviewControl
• GetViewRendering
• PreviewControlDesigner
• Обзор конструкторов элементов управления ASP.NET