Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

SupportsPreviewControlAttribute (Clase)

Indica si un diseñador de controles requiere una instancia de vista preliminar del control en tiempo de diseño. Esta clase no puede heredarse.

System.Object
  System.Attribute
    System.Web.UI.Design.SupportsPreviewControlAttribute

Espacio de nombres:  System.Web.UI.Design
Ensamblado:  System.Design (en System.Design.dll)
[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class SupportsPreviewControlAttribute : Attribute

El tipo SupportsPreviewControlAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoSupportsPreviewControlAttributeInicializa una instancia nueva de la clase SupportsPreviewControlAttribute y establece el valor inicial de la propiedad SupportsPreviewControl.
Arriba
  NombreDescripción
Propiedad públicaSupportsPreviewControlObtiene un valor que indica si el diseñador de controles requiere un control de vista preliminar temporal en tiempo de diseño.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Arriba
  NombreDescripción
Método públicoEqualsDetermina si el objeto especificado representa la misma configuración de atributo de vista preliminar que la instancia actual de la clase SupportsPreviewControlAttribute. (Invalida a Attribute.Equals(Object)).
Método públicoGetHashCodeDevuelve el código hash de esta instancia de la clase SupportsPreviewControlAttribute. (Invalida a Attribute.GetHashCode()).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeIndica si la instancia actual de la clase SupportsPreviewControlAttribute está establecida en el valor del atributo de la vista preliminar predeterminado. (Invalida a Attribute.IsDefaultAttribute()).
Método públicoMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba
  NombreDescripción
Campo públicoMiembro estáticoDefaultObtiene una instancia de la clase SupportsPreviewControlAttribute establecida en el valor de vista preliminar predeterminado. Este campo es de sólo lectura.
Arriba
  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

Aplique el atributo SupportsPreviewControlAttribute a una clase de diseñador de controles para indicar el tipo de control de vista preliminar que admite el diseñador de controles. Utilice este atributo para cambiar la representación de un control de vista preliminar para tiempo de diseño sin afectar a la instancia almacenada real del control asociado.

Normalmente, SupportsPreviewControlAttribute se especifica al declarar una clase de diseñador personalizada que se deriva de la clase ControlDesigner. El valor de la propiedad SupportsPreviewControl del atributo SupportsPreviewControlAttribute determina el comportamiento de los miembros UsePreviewControl y ViewControl de la clase base ControlDesigner.

Establezca la propiedad SupportsPreviewControl en true para indicar que el diseñador utiliza una copia temporal del control asociado para generar el HTML en tiempo de diseño. Los cambios del control temporal no se conservan.

Establezca la propiedad SupportsPreviewControl en false para indicar que el diseñador devuelve la instancia del control, específicamente la propiedad Component, del método ViewControl. Los cambios del objeto de control se conservan.

Por ejemplo, la clase CalendarDesigner se marca con SupportsPreviewControlAttribute establecida en true. El diseñador utiliza el control de vista preliminar con la tarea que da formato de estilo automático, que permite al usuario ofrecer una vista previa de distintos estilos de autoformato que se pueden aplicar al calendario. Cuando el usuario selecciona diferentes estilos de autoformato en la interfaz de usuario, el esquema de estilo seleccionado se aplica al control de vista preliminar. Al aplicar un estilo nuevo al control de vista preliminar, no se cambia el esquema aplicado a la instancia del control Calendar en el diseñador.

Si SupportsPreviewControlAttribute no se especifica en la declaración del diseñador de controles, el comportamiento de ControlDesigner equivale a especificar SupportsPreviewControl como false.

NotaNota

Las clases de diseñador derivadas de la clase ControlDesigner pueden reemplazar los miembros UsePreviewControl y ViewControl y omiten el atributo SupportsPreviewControlAttribute. Para averiguar el comportamiento esperado de ViewControl y UsePreviewControl, consulte la documentación existente de referencia para la clase de diseñador de controles derivados.

Para obtener información general acerca del uso de atributos, vea Attributes Overview y Extender metadatos mediante atributos. Para obtener más información acerca de los atributos en tiempo de diseño, vea Atributos y compatibilidad en tiempo de diseño.

En el ejemplo de código siguiente se muestra cómo marcar un diseñador de controles con el atributo SupportsPreviewControlAttribute. El ejemplo de código deriva un control de servidor ASP.NET de la clase Label y lo asocia a una implementación del diseñador de controles personalizado. La declaración de clase del diseñador de controles se marca con el atributo SupportsPreviewControl establecido en true. El diseñador de controles reemplaza el método GetDesignTimeHtml y el HTML en tiempo de diseño del control va entre etiquetas de cursiva.


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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.