LoginDesigner Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona compatibilidad en tiempo de diseño en un diseñador visual para el control de servidor web Login.
public ref class LoginDesigner : System::Web::UI::Design::WebControls::CompositeControlDesigner
public class LoginDesigner : System.Web.UI.Design.WebControls.CompositeControlDesigner
type LoginDesigner = class
inherit CompositeControlDesigner
Public Class LoginDesigner
Inherits CompositeControlDesigner
- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo extender la LoginDesigner clase para cambiar la apariencia de los controles derivados del Login control en tiempo de diseño.
En el ejemplo se deriva el MyLogin
control de Login.
MyLogin
es una copia del Login control . El ejemplo también deriva la MyLoginDesigner
clase de LoginDesigner y aplica un DesignerAttribute atributo para en MyLoginDesigner
el MyLogin
control .
MyLoginDesigner
Invalida el PreFilterProperties método para que la NamingContainer propiedad sea visible en la cuadrícula Propiedades en tiempo de diseño. Invalida el GetDesignTimeHtml método para dibujar un borde azul y discontinuo alrededor del control para que su extensión sea más visible, si la BorderStyle propiedad del MyLogin
control es el NotSet valor o None . Invalida el GetErrorDesignTimeHtml método para generar el marcado de un marcador de posición que incluye el mensaje de error representado en texto rojo y en negrita.
using System;
using System.Web;
using System.Drawing;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The MyLogin is a copy of the Login.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.MyLoginDesigner))]
public class MyLogin : Login
{
} // MyLogin
// Override members of the LoginDesigner.
[ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
public class MyLoginDesigner : LoginDesigner
{
// Generate the design-time markup for the control when an error occurs.
protected override string GetErrorDesignTimeHtml(Exception e)
{
// Write the error message text in red, bold.
string errorRendering =
"<span style=\"font-weight:bold; color:Red; \">" +
e.Message + "</span>";
return CreatePlaceHolderDesignTimeHtml(errorRendering);
} // GetErrorDesignTimeHtml
// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base method first.
base.PreFilterProperties(properties);
// Make the NamingContainer visible in the Properties grid.
PropertyDescriptor selectProp =
(PropertyDescriptor)properties["NamingContainer"];
properties["NamingContainer"] =
TypeDescriptor.CreateProperty(selectProp.ComponentType,
selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties
// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
// Make the control more visible in the designer. If the border
// style is None or NotSet, change the border to a blue dashed line.
MyLogin myLoginCtl = (MyLogin)ViewControl;
string markup = null;
// Check if the border style should be changed.
if (myLoginCtl.BorderStyle == BorderStyle.NotSet ||
myLoginCtl.BorderStyle == BorderStyle.None)
{
BorderStyle oldBorderStyle = myLoginCtl.BorderStyle;
Color oldBorderColor = myLoginCtl.BorderColor;
// Set the design time properties and catch any exceptions.
try
{
myLoginCtl.BorderStyle = BorderStyle.Dashed;
myLoginCtl.BorderColor = Color.Blue;
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
markup = GetErrorDesignTimeHtml(ex);
}
finally
{
// It is not necessary to restore the border properties
// to their original values because the ViewControl
// was used to reference the associated control and the
// UsePreviewControl was not overridden.
// myLoginCtl.BorderStyle = oldBorderStyle;
// myLoginCtl.BorderColor = oldBorderColor;
}
}
else
{
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
return markup;
} // GetDesignTimeHtml
} // MyLoginDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Drawing
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The MyLogin is a copy of the Login.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design.MyLoginDesigner))> _
Public Class MyLogin
Inherits Login
End Class
' Override members of the LoginDesigner.
<ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
Public Class MyLoginDesigner
Inherits LoginDesigner
' Generate the design-time markup for the control when an error occurs.
Protected Overrides Function GetErrorDesignTimeHtml( _
ByVal ex As Exception) As String
' Write the error message text in red, bold.
Dim errorRendering As String = _
"<span style=""font-weight:bold; color:Red; "">" & _
ex.Message & "</span>"
Return CreatePlaceHolderDesignTimeHtml(errorRendering)
End Function ' GetErrorDesignTimeHtml
' Shadow the control properties with design-time properties.
Protected Overrides Sub PreFilterProperties( _
ByVal properties As IDictionary)
' Call the base method first.
MyBase.PreFilterProperties(properties)
' Make the NamingContainer visible in the Properties grid.
Dim selectProp As PropertyDescriptor = _
CType(properties("NamingContainer"), PropertyDescriptor)
properties("NamingContainer") = _
TypeDescriptor.CreateProperty(selectProp.ComponentType, _
selectProp, BrowsableAttribute.Yes)
End Sub
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String
' Make the control more visible in the designer. If the border
' style is None or NotSet, change the border to a blue dashed line.
Dim myLoginCtl As MyLogin = CType(ViewControl, MyLogin)
Dim markup As String = Nothing
' Check if the border style should be changed.
If (myLoginCtl.BorderStyle = BorderStyle.NotSet Or _
myLoginCtl.BorderStyle = BorderStyle.None) Then
Dim oldBorderStyle As BorderStyle = myLoginCtl.BorderStyle
Dim oldBorderColor As Color = myLoginCtl.BorderColor
' Set the design time properties and catch any exceptions.
Try
myLoginCtl.BorderStyle = BorderStyle.Dashed
myLoginCtl.BorderColor = Color.Blue
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
markup = GetErrorDesignTimeHtml(ex)
Finally
' It is not necessary to restore the border properties
' to their original values because the ViewControl
' was used to reference the associated control and the
' UsePreviewControl was not overridden.
' myLoginCtl.BorderStyle = oldBorderStyle
' myLoginCtl.BorderColor = oldBorderColor
End Try
Else
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
End If
Return markup
End Function ' GetDesignTimeHtml
End Class
End Namespace ' Examples.VB.WebControls.Design
Comentarios
El Login control muestra una interfaz de usuario que permite al usuario iniciar sesión en el sitio web host.
En un diseñador visual, al cambiar de la vista Origen a Diseño, el código fuente de marcado que describe el Login control se analiza y se crea una versión en tiempo de diseño del control en la superficie de diseño. Al volver a la vista Origen, el control en tiempo de diseño se conserva en el código fuente de marcado y se edita en el marcado de la página web. La LoginDesigner clase proporciona compatibilidad en tiempo de diseño para el Login control .
Las LoginDesigner propiedades de clase proporcionan la siguiente funcionalidad:
La ActionLists propiedad devuelve un DesignerActionListCollection objeto , que normalmente contiene un objeto derivado de la DesignerActionList clase para cada nivel del árbol de herencia del diseñador.
La AutoFormats propiedad devuelve una colección de esquemas de formato para mostrarse en el cuadro de diálogo Formato automático .
La TemplateGroups propiedad devuelve una colección de grupos de plantillas para los campos del control asociado Login y la plantilla de nivel Login superior.
La UsePreviewControl propiedad siempre devuelve
true
, lo que indica que el diseñador crea una copia temporal del asociado Login para generar el marcado en tiempo de diseño.
Los LoginDesigner métodos de clase proporcionan la siguiente funcionalidad:
El GetDesignTimeHtml método devuelve el marcado que se usa para representar el asociado Login en tiempo de diseño.
El GetEditableDesignerRegionContent método devuelve una copia serializada de la plantilla para el asociado Login.
El GetErrorDesignTimeHtml método proporciona el marcado que se usa para representar el asociado Login en tiempo de diseño cuando se ha producido un error.
El Initialize método prepara el diseñador para ver, editar y diseñar el asociado Login.
El PreFilterProperties método se usa para quitar propiedades de , agregar propiedades adicionales a o propiedades de sombra del asociado Login.
El SetEditableDesignerRegionContent método establece una región del asociado Login a una copia serializada de una plantilla de control.
Constructores
LoginDesigner() |
Inicializa una nueva instancia de la clase LoginDesigner. |
Propiedades
ActionLists |
Obtiene la colección de listas de acciones para este diseñador. |
AllowResize |
Obtiene o establece un valor que especifica si el control LoginDesigner admite un cambio de tamaño. |
AllowResize |
Obtiene un valor que indica si se puede cambiar el tamaño del control en el entorno en tiempo de diseño. (Heredado de ControlDesigner) |
AssociatedComponents |
Obtiene la colección de componentes asociados al componente administrado por el diseñador. (Heredado de ComponentDesigner) |
AutoFormats |
Obtiene la colección de esquemas de formato predefinidos que se va a mostrar en el cuadro de diálogo Formato automático. |
Behavior |
Obsoletos.
Obtiene o establece el comportamiento DHTML asociado al diseñador. (Heredado de HtmlControlDesigner) |
Component |
Obtiene el componente que el diseñador está creando. (Heredado de ComponentDesigner) |
DataBindings |
Obtiene la colección de enlaces de datos del control actual. (Heredado de HtmlControlDesigner) |
DataBindingsEnabled |
Obtiene un valor que indica si la región contenedora del control asociado permite el enlace a datos. (Heredado de ControlDesigner) |
DesignerState |
Obtiene un objeto que se utiliza para guardar los datos del control asociado en tiempo de diseño. (Heredado de ControlDesigner) |
DesignTimeElement |
Obsoletos.
Obtiene el objeto en tiempo de diseño que representa el control asociado al objeto HtmlControlDesigner en la superficie de diseño. (Heredado de HtmlControlDesigner) |
DesignTimeElementView |
Obsoletos.
Obtiene el objeto de control de vista para el diseñador de controles. (Heredado de ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
Obsoletos.
Obtiene un valor que indica si el host de diseño debe terminar de cargarse antes de que se pueda llamar al método GetDesignTimeHtml. (Heredado de ControlDesigner) |
Expressions |
Obtiene los enlaces de expresión en tiempo de diseño para el control actual. (Heredado de HtmlControlDesigner) |
HidePropertiesInTemplateMode |
Obtiene un valor que indica si las propiedades del control asociado están ocultas cuando el control está en modo de plantilla. (Heredado de ControlDesigner) |
ID |
Obtiene o establece la cadena del identificador del control. (Heredado de ControlDesigner) |
InheritanceAttribute |
Obtiene un atributo que indica el tipo de herencia del componente asociado. (Heredado de ComponentDesigner) |
Inherited |
Obtiene un valor que indica si este componente es heredado. (Heredado de ComponentDesigner) |
InTemplateMode |
Obtiene un valor que indica si el control está en el modo de vista o de edición de plantilla en el host de diseño. La propiedad InTemplateMode es de sólo lectura. (Heredado de ControlDesigner) |
IsDirty |
Obsoletos.
Obtiene o establece un valor que indica si el control de servidor Web se ha marcado como modificado. (Heredado de ControlDesigner) |
ParentComponent |
Obtiene el componente primario de este diseñador. (Heredado de ComponentDesigner) |
ReadOnly |
Obsoletos.
Obtiene o establece un valor que indica si las propiedades del control son de sólo lectura en tiempo de diseño. (Heredado de ControlDesigner) |
RenderOuterTable |
Obtiene o establece un valor que especifica si el control LoginDesigner emplea un contenedor de tablas externas para aplicar las reglas de estilo CSS en línea. |
RootDesigner |
Obtiene el diseñador de controles para la página de formularios Web Forms que contiene el control asociado. (Heredado de ControlDesigner) |
SetTextualDefaultProperty |
Proporciona compatibilidad en tiempo de diseño en un diseñador visual para el control de servidor web Login. (Heredado de ComponentDesigner) |
ShadowProperties |
Obtiene una colección de valores de propiedad que reemplazan la configuración del usuario. (Heredado de ComponentDesigner) |
ShouldCodeSerialize |
Obsoletos.
Obtiene o establece un valor que indica si se debe crear una declaración de campo para el control en el archivo de código subyacente para el documento de diseño actual durante la serialización. (Heredado de HtmlControlDesigner) |
Tag |
Obtiene un objeto que representa el elemento de formato HTML del control asociado. (Heredado de ControlDesigner) |
TemplateGroups |
Obtiene una colección de grupos de plantillas para los campos del control asociado. |
UsePreviewControl |
Obtiene un valor que indica si el diseñador debe usar una copia temporal, en lugar del control real que está asociado al diseñador, para generar el marcado en tiempo de diseño. |
Verbs |
Obtiene los verbos en tiempo de diseño que admite el componente asociado al diseñador. (Heredado de ComponentDesigner) |
ViewControl |
Obtiene o establece un control de servidor Web que se puede utilizar para ofrecer una vista previa del formato HTML en tiempo de diseño. (Heredado de ControlDesigner) |
ViewControlCreated |
Obtiene o establece un valor que indica si se ha creado un control |
Visible |
Obtiene un valor que indica si el control está visible en tiempo de diseño. (Heredado de ControlDesigner) |
Métodos
CreateChildControls() |
Crea los controles secundarios de este control CompositeControl. (Heredado de CompositeControlDesigner) |
CreateErrorDesignTimeHtml(String) |
Crea el formato HTML para mostrar un mensaje de error especificado en tiempo de diseño. (Heredado de ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Crea el formato HTML para mostrar un mensaje de error de excepción especificado en tiempo de diseño. (Heredado de ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control. (Heredado de ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control, así como instrucciones o información adicionales que se hayan especificado. (Heredado de ControlDesigner) |
CreateViewControl() |
Devuelve una copia del control asociado para verlo o representarlo en la superficie de diseño. (Heredado de ControlDesigner) |
Dispose() |
Libera todos los recursos que usa ComponentDesigner. (Heredado de ComponentDesigner) |
Dispose(Boolean) |
Libera los recursos no administrados utilizados por el objeto HtmlControlDesigner y, de forma opcional, libera los recursos administrados. (Heredado de HtmlControlDesigner) |
DoDefaultAction() |
Crea una firma de método en el archivo de código fuente para el evento predeterminado del componente y hace navegar el cursor del usuario en esa ubicación. (Heredado de ComponentDesigner) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetBounds() |
Recupera las coordenadas del rectángulo que representa los límites del control mostrado en la superficie de diseño. (Heredado de ControlDesigner) |
GetDesignTimeHtml() |
Obtiene el código HTML que se usa para representar el control en tiempo de diseño. (Heredado de CompositeControlDesigner) |
GetDesignTimeHtml(DesignerRegionCollection) |
Obtiene el marcado que se utiliza para presentar el control asociado en tiempo de diseño y rellena una colección de regiones del diseñador. |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Devuelve una copia serializada de la plantilla utilizada para representar el control asociado en tiempo de diseño. |
GetEmptyDesignTimeHtml() |
Recupera el formato HTML para presentar un control de servidor web en tiempo de diseño que no tendrá ninguna representación visual en tiempo de ejecución. (Heredado de ControlDesigner) |
GetErrorDesignTimeHtml(Exception) |
Proporciona el marcado que se usa para representar el control asociado en tiempo de diseño cuando se produce un error. |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetPersistenceContent() |
Recupera el formato HTML interno con persistencia del control en tiempo de diseño. (Heredado de ControlDesigner) |
GetPersistInnerHtml() |
Obsoletos.
Recupera el formato HTML interno con persistencia del control. (Heredado de ControlDesigner) |
GetService(Type) |
Intenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador. (Heredado de ComponentDesigner) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
GetViewRendering() |
Recupera un objeto que contiene el formato en tiempo de diseño para el contenido y las regiones del control asociado. (Heredado de ControlDesigner) |
Initialize(IComponent) |
Prepara el diseñador para poder ver, modificar y diseñar el control asociado. |
InitializeExistingComponent(IDictionary) |
Reinicializa un componente existente. (Heredado de ComponentDesigner) |
InitializeNewComponent(IDictionary) |
Inicializa un componente recién creado. (Heredado de ComponentDesigner) |
InitializeNonDefault() |
Obsoletos.
Obsoletos.
Inicializa la configuración de un componente importado que ya se ha inicializado con una configuración que no es la predeterminada. (Heredado de ComponentDesigner) |
Invalidate() |
Invalida todo el área del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner) |
Invalidate(Rectangle) |
Invalida el área especificada del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner) |
InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtiene el objeto InheritanceAttribute de la enumeración ComponentDesigner especificada. (Heredado de ComponentDesigner) |
IsPropertyBound(String) |
Obsoletos.
Recupera un valor que indica si la propiedad especificada en el control asociado está enlazada a datos o no. (Heredado de ControlDesigner) |
Localize(IDesignTimeResourceWriter) |
Utiliza el sistema de escritura de recursos proporcionado para conservar las propiedades adaptables del control asociado en un recurso en el host de diseño. (Heredado de ControlDesigner) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
OnAutoFormatApplied(DesignerAutoFormat) |
Se le llama cuando se ha aplicado un esquema de formato automático predefinido al control asociado. (Heredado de ControlDesigner) |
OnBehaviorAttached() |
Se llama cuando el diseñador de controles está asociado a un objeto Behavior. (Heredado de ControlDesigner) |
OnBehaviorDetaching() |
Obsoletos.
Se le llama cuando se anula la asociación de un comportamiento al elemento. (Heredado de HtmlControlDesigner) |
OnBindingsCollectionChanged(String) |
Obsoletos.
Se le llama cuando cambia la colección de enlace a datos. (Heredado de ControlDesigner) |
OnClick(DesignerRegionMouseEventArgs) |
Lo llama el host de diseño cuando el usuario hace clic en el control asociado en tiempo de diseño. (Heredado de ControlDesigner) |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Se le llama cuando cambia el control asociado. (Heredado de ControlDesigner) |
OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa el método que controlará el evento ComponentChanging del control asociado. (Heredado de ControlDesigner) |
OnControlResize() |
Obsoletos.
Se le llama cuando el control de servidor Web asociado ha cambiado de tamaño en tiempo de diseño en el host de diseño. (Heredado de ControlDesigner) |
OnPaint(PaintEventArgs) |
Se le llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el valor CustomPaint es |
OnSetComponentDefaults() |
Obsoletos.
Obsoletos.
Establece las propiedades predeterminadas del componente. (Heredado de ComponentDesigner) |
OnSetParent() |
Proporciona una manera de realizar el procesamiento adicional cuando el control asociado se asocia a un control primario. (Heredado de HtmlControlDesigner) |
PostFilterAttributes(IDictionary) |
Permite a un diseñador cambiar o quitar elementos en el conjunto de atributos que expone mediante un TypeDescriptor. (Heredado de ComponentDesigner) |
PostFilterEvents(IDictionary) |
Permite a un diseñador cambiar o quitar elementos del conjunto de eventos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
PostFilterProperties(IDictionary) |
Permite a un diseñador cambiar o quitar elementos del conjunto de propiedades que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
PreFilterAttributes(IDictionary) |
Permite a un diseñador agregar elementos al conjunto de atributos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
PreFilterEvents(IDictionary) |
Establece la lista de eventos que se exponen en tiempo de diseño para el objeto TypeDescriptor para el componente. (Heredado de HtmlControlDesigner) |
PreFilterProperties(IDictionary) |
La usa el diseñador para quitar o agregar propiedades en la presentación de la cuadrícula Propiedades, o para reemplazar propiedades del control asociado. |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica a IComponentChangeService que este componente se ha cambiado. (Heredado de ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Notifica a IComponentChangeService que este componente se va a cambiar. (Heredado de ComponentDesigner) |
RaiseResizeEvent() |
Obsoletos.
Genera el evento OnControlResize(). (Heredado de ControlDesigner) |
RegisterClone(Object, Object) |
Registra los datos internos en un control clonado. (Heredado de ControlDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Establece una región del control asociado a partir de una copia serializada de una plantilla de control. |
SetRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región modificable en la vista en tiempo de diseño del control. (Heredado de ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Asigna la enumeración ViewFlags bit a bit especificada al valor de marcador especificado. (Heredado de ControlDesigner) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
UpdateDesignTimeHtml() |
Actualiza el formato HTML en tiempo de diseño para el control de servidor Web asociado llamando al método GetDesignTimeHtml. (Heredado de ControlDesigner) |