ControlDesigner.UsePreviewControl Propriété

Référence

Définition

Espace de noms:: System.Web.UI.Design

Assembly:: System.Design.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une valeur indiquant si le concepteur de contrôles utilise un contrôle d’aperçu temporaire pour générer le balisage HTML au moment du design.

protected:
 virtual property bool UsePreviewControl { bool get(); };

protected virtual bool UsePreviewControl { get; }

member this.UsePreviewControl : bool

Protected Overridable ReadOnly Property UsePreviewControl As Boolean

Valeur de propriété

Boolean

true si le concepteur de contrôles utilise une copie temporaire du contrôle pour l’aperçu au moment du design ; sinon, false, si le concepteur de contrôles utilise la propriété Component pour le contrôle contenu dans le concepteur de contrôles.

Remarques

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

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

Le SupportsPreviewControl paramètre de l’objet SupportsPreviewControlAttribute est utilisé pour définir la valeur de la UsePreviewControl propriété. Par conséquent, le SupportsPreviewControl paramètre détermine le type de contrôle retourné par la ViewControl propriété dans la classe de base ControlDesigner . Si le SupportsPreviewControlAttribute paramètre n’est pas spécifié dans la déclaration du concepteur de contrôles, le ControlDesigner comportement de l’objet équivaut à spécifier la SupportsPreviewControl propriété en tant que false.

Notes pour les héritiers

Les concepteurs personnalisés dérivés de la ControlDesigner classe peuvent remplacer la UsePreviewControl propriété et ignorer l’objet SupportsPreviewControlAttribute . En règle générale, pour indiquer que la ViewControl propriété retourne toujours une copie temporaire du contrôle, remplacez la UsePreviewControl propriété pour toujours retourner true. Pour indiquer que la ViewControl propriété retourne toujours une instance du contrôle, remplacez la UsePreviewControl propriété pour toujours retourner false. Par exemple, la PreviewControlDesigner classe dérive de la ControlDesigner propriété et retourne true toujours pour la UsePreviewControl propriété.

S’applique à