Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

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; }

Valeur de propriété

Type : System.Web.UI.Control
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 du contrôle temporaire ne sont pas 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 à l'aide de 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 à l'aide de l'attribut SupportsPreviewControl prenant la valeur 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.
    }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft