ControlDesigner.ViewControl Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um controle de servidor Web que pode ser usado para visualizar a marcação HTML de tempo de design.
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, setPublic Property ViewControl As ControlValor da propriedade
Um Control objeto usado pela classe base para gerar marcação HTML em tempo de design.
Exemplos
O exemplo de código a seguir demonstra como marcar um designer de controle com o SupportsPreviewControlAttribute atributo . O exemplo de código deriva um controle de servidor Web da Label classe e associa o controle a uma implementação personalizada do designer de controle. A declaração de classe do designer de controle é marcada com o SupportsPreviewControl atributo definido como true. O designer de controle substitui o GetDesignTimeHtml método e exibe a Text propriedade do controle em itálico em tempo de design.
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
Comentários
A ViewControl propriedade usa a UsePreviewControl propriedade para determinar seu valor retornado.
Se a UsePreviewControl propriedade for true, a ViewControl propriedade retornará uma cópia temporária do controle. As alterações no controle temporário não são persistentes.
Se a UsePreviewControl propriedade for false, a ViewControl propriedade retornará uma instância da Component propriedade para o controle . As alterações na instância do controle são persistentes.
A SupportsPreviewControl configuração no SupportsPreviewControlAttribute objeto é usada para definir o valor da UsePreviewControl propriedade . Portanto, a SupportsPreviewControl configuração determina o tipo de controle retornado pela ViewControl propriedade na classe base ControlDesigner . Se o SupportsPreviewControlAttribute não for especificado na declaração do designer de controle, o comportamento do ControlDesigner objeto será equivalente a especificar a SupportsPreviewControl propriedade como false.
