Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ControlDesigner.ViewControl, propriété

Obtient ou définit un contrôle serveur Web qui peut être utilisé pour afficher un aperçu du balisage HTML au moment du design.

Espace de noms: System.Web.UI.Design
Assembly : System.Design (dans system.design.dll)

public Control ViewControl { get; set; }
/** @property */
public Control get_ViewControl ()

/** @property */
public void set_ViewControl (Control value)

public function get ViewControl () : Control

public function set ViewControl (value : Control)

Non applicable.

Valeur de la propriété

Objet Control utilisé par la classe de base pour générer le balisage HTML au moment du design.

La propriété ViewControl utilise la propriété UsePreviewControl pour déterminer sa valeur de retour.

Si la propriété UsePreviewControl est true, la propriété ViewControl retourne une copie temporaire du contrôle. Les modifications apportées au contrôle temporaire ne sont pas rendues persistantes.

Si la propriété UsePreviewControl est false, la propriété ViewControl retourne une instance de la propriété Component du contrôle. Les modifications apportées à l'instance du contrôle sont rendues persistantes.

Le paramètre SupportsPreviewControl de l'objet SupportsPreviewControlAttribute est utilisé pour définir la valeur de la propriété UsePreviewControl. Par conséquent, le paramètre SupportsPreviewControl détermine le type de contrôle retourné par la propriété ViewControl dans la classe ControlDesigner de base. Si SupportsPreviewControlAttribute n'est pas spécifié dans la déclaration de Concepteur de contrôles, le comportement de l'objet ControlDesigner est équivalent à la spécification de la propriété SupportsPreviewControl comme false.

L'exemple de code suivant montre comment marquer un Concepteur de contrôles avec l'attribut SupportsPreviewControlAttribute. L'exemple de code dérive un contrôle serveur Web de la classe Label et associe le contrôle à une implémentation de Concepteur de contrôles personnalisée. La déclaration de classe de Concepteur de contrôles est marquée avec l'ensemble d'attributs SupportsPreviewControl à true. Le Concepteur de contrôles substitue la méthode GetDesignTimeHtml et affiche la propriété Text du contrôle en italique au moment du 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.
    }
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.