DataGridDesigner 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í.
Extiende el comportamiento en tiempo de diseño para el control de DataGrid servidor web.
public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesignerpublic class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesignertype DataGridDesigner = class
inherit BaseDataListDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
inherit BaseDataListDesignerPublic Class DataGridDesigner
Inherits BaseDataListDesigner- Herencia
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra cómo extender la DataGridDesigner clase . El código invalida el GetDesignTimeHtml método para personalizar las CellPaddingpropiedades , BorderWidthy BorderColor cuando el DataGrid control se representa en una superficie de diseño.
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.Drawing
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace Examples.AspNet
' Create a designer class for the SimpleDataList class.
<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.Demand, _
Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Class SimpleDataListDesigner
Inherits DataListDesigner
Private simpleList As SimpleDataList
' Override the GetDesignTimeHtml method to add style to the control
' on the design surface.
Public Overrides Function GetDesignTimeHtml() As String
' Cast the control to the Component property of the designer.
simpleList = CType(Component, SimpleDataList)
Dim designTimeHtml As String = Nothing
' Create variables to hold current property values.
Dim oldBorderWidth As Unit = simpleList.BorderWidth
Dim oldBorderColor As Color = simpleList.BorderColor
' Set the properties and generate the design-time HTML.
If (simpleList.Enabled) Then
Try
simpleList.BorderWidth = Unit.Point(5)
simpleList.BorderColor = Color.Purple
designTimeHtml = MyBase.GetDesignTimeHtml()
' Call the GetErrorDesignTimeHtml method if an
' exception occurs.
Catch ex As Exception
designTimeHtml = GetErrorDesignTimeHtml(ex)
' Return the properties to their original settings.
Finally
simpleList.BorderWidth = oldBorderWidth
simpleList.BorderColor = oldBorderColor
End Try
' If the list is not enabled, call the GetEmptyDesignTimeHtml
' method.
Else
designTimeHtml = GetEmptyDesignTimeHtml()
End If
Return designTimeHtml
End Function
Protected Overrides Function GetEmptyDesignTimeHtml() As String
Dim emptyText As String
' Check the CanEnterTemplateMode property to
' specify which text to display if ItemTemplate
' does not contain a value.
If CanEnterTemplateMode Then
emptyText = _
"<b>Either the Enabled property value is false " + _
"or you need to set the ItemTemplate for this " + _
"control.<br>Right-click to edit templates.</b>"
Else
emptyText = _
"<b>You cannot edit templates in this view.<br>" + _
"Switch to HTML view to define the ItemTemplate.</b>"
End If
Return CreatePlaceHolderDesignTimeHtml(emptyText)
End Function
' Generate HTML to indicate that an error has occurred.
Protected Overrides Function GetErrorDesignTimeHtml(ByVal exc As _
Exception) As String
Return CreatePlaceHolderDesignTimeHtml( _
"<b>An error occurred</b>.<br>Check to ensure that all " + _
"properties are valid.")
End Function
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
End Class
End Namespace
En el ejemplo siguiente se muestra cómo usar el DesignerAttribute atributo para asociar el diseñador con el DataGrid control .
' Override the Initialize method to ensure that
' only an instance of the SimpleDataList class is
' used by this designer class.
Public Overrides Sub Initialize(ByVal component As IComponent)
simpleList = CType(component, SimpleDataList)
If IsNothing(simpleList) Then
Throw New ArgumentException("Must be a SimpleDataList.", "component")
End If
MyBase.Initialize(component)
End Sub
Constructores
| Nombre | Description |
|---|---|
| DataGridDesigner() |
Inicializa una nueva instancia de la clase DataGridDesigner. |
Propiedades
| Nombre | Description |
|---|---|
| ActionLists |
Obtiene la colección de listas de acciones del diseñador para este diseñador. (Heredado de BaseDataListDesigner) |
| ActiveTemplateEditingFrame |
Obsoletos.
Obtiene el marco de edición de plantillas activo. (Heredado de TemplatedControlDesigner) |
| AllowResize |
Obtiene un valor que indica si el control se puede cambiar de tamaño 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 el DesignerAutoFormatCollection objeto asociado a este diseñador. |
| Behavior |
Obsoletos.
Obtiene o establece el comportamiento DHTML asociado al diseñador. (Heredado de HtmlControlDesigner) |
| CanEnterTemplateMode |
Obtiene un valor que indica si este diseñador permitirá o no la visualización o edición de plantillas. (Heredado de TemplatedControlDesigner) |
| Component |
Obtiene el componente que este diseñador está diseñando. (Heredado de ComponentDesigner) |
| DataBindings |
Obtiene la colección de enlaces de datos para el control actual. (Heredado de HtmlControlDesigner) |
| DataBindingsEnabled |
Obtiene un valor que indica si el diseñador permite el enlace de datos. (Heredado de TemplatedControlDesigner) |
| DataKeyField |
Obtiene o establece el valor del campo de clave de datos del control asociado. (Heredado de BaseDataListDesigner) |
| DataMember |
Obtiene o establece el valor del campo miembro de datos del control asociado. (Heredado de BaseDataListDesigner) |
| DataSource |
Obtiene o establece el valor de la propiedad de origen de datos del control asociado. (Heredado de BaseDataListDesigner) |
| DataSourceDesigner |
Obtiene el diseñador del origen de datos, cuando se selecciona uno para el enlace de datos. (Heredado de BaseDataListDesigner) |
| DataSourceID |
Obtiene o establece la versión del diseñador de la propiedad id. de origen de datos y se usa para sombrear la propiedad correspondiente del control asociado. (Heredado de BaseDataListDesigner) |
| DesignerState |
Obtiene un objeto que se usa para conservar los datos del control asociado en tiempo de diseño. (Heredado de ControlDesigner) |
| DesignerView |
Obtiene la vista predeterminada del origen de datos enlazado al control asociado. (Heredado de BaseDataListDesigner) |
| DesignTimeElement |
Obsoletos.
Obtiene el objeto en tiempo de diseño que representa el control asociado al HtmlControlDesigner objeto en la superficie de diseño. (Heredado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoletos.
Obtiene el objeto view-control para el diseñador de controles. (Heredado de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obtiene un valor que indica si la carga debe completarse para mostrar el marcado en tiempo de diseño. (Heredado de BaseDataListDesigner) |
| Expressions |
Obtiene los enlaces de expresión para el control actual en tiempo de diseño. (Heredado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Obtiene un valor que indica si las propiedades del control se ocultarán cuando el control se coloque en modo de edición de plantillas. (Heredado de TemplatedControlDesigner) |
| ID |
Obtiene o establece la cadena de 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 se hereda este componente. (Heredado de ComponentDesigner) |
| InTemplateMode |
Obsoletos.
Obtiene un valor que indica si el documento del diseñador está en modo de plantilla. (Heredado de TemplatedControlDesigner) |
| 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 solo lectura en tiempo de diseño. (Heredado de ControlDesigner) |
| RootDesigner |
Obtiene el diseñador de controles de la página de formularios Web Forms que contiene el control asociado. (Heredado de ControlDesigner) |
| ShadowProperties |
Obtiene una colección de valores de propiedad que invalidan la configuración del usuario. (Heredado de ComponentDesigner) |
| ShouldCodeSerialize |
Obsoletos.
Obtiene o establece un valor que indica si se va a crear una declaración de campo para el control en el archivo de código subyacente del documento de diseño actual durante la serialización. (Heredado de HtmlControlDesigner) |
| Tag |
Obtiene un objeto que representa el elemento de marcado HTML para el control asociado. (Heredado de ControlDesigner) |
| TemplateGroups |
Obtiene una colección de grupos de plantillas, cada una que contiene una definición de plantilla. (Heredado de TemplatedControlDesigner) |
| UsePreviewControl |
Obtiene un valor que indica si el diseñador de controles usa un control de vista previa temporal para generar el marcado HTML en tiempo de diseño. (Heredado de ControlDesigner) |
| Verbs |
Obtiene la colección de verbos disponibles para este diseñador. (Heredado de BaseDataListDesigner) |
| ViewControl |
Obtiene o establece un control de servidor web que se puede usar para obtener una vista previa del marcado HTML en tiempo de diseño. (Heredado de ControlDesigner) |
| ViewControlCreated |
Obtiene o establece un valor que indica si se ha creado un |
| Visible |
Obtiene un valor que indica si el control está visible en tiempo de diseño. (Heredado de ControlDesigner) |
Métodos
| Nombre | Description |
|---|---|
| CreateErrorDesignTimeHtml(String, Exception) |
Crea el marcado HTML para mostrar un mensaje de error de excepción especificado en tiempo de diseño. (Heredado de ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Crea marcado HTML para mostrar un mensaje de error especificado en tiempo de diseño. (Heredado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Proporciona una representación simple de marcador de posición rectangular que muestra el tipo y el identificador del control. (Heredado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Proporciona una representación simple de marcador de posición rectangular que muestra el tipo y el identificador del control, así como instrucciones o información adicionales especificadas. (Heredado de ControlDesigner) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Obsoletos.
Crea un marco de edición de plantillas con el verbo especificado. |
| CreateViewControl() |
Devuelve una copia del control asociado para ver o representar en la superficie de diseño. (Heredado de ControlDesigner) |
| Dispose() |
Libera todos los recursos usados por .ComponentDesigner (Heredado de ComponentDesigner) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por el DataGridDesigner objeto y, opcionalmente, libera los recursos administrados. |
| DoDefaultAction() |
Crea una firma de método en el archivo de código fuente para el evento predeterminado en el componente y navega el cursor del usuario a esa ubicación. (Heredado de ComponentDesigner) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsoletos.
Abre un objeto de marco de plantilla determinado para su edición en el diseñador. (Heredado de TemplatedControlDesigner) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| ExitTemplateMode(Boolean, Boolean, Boolean) |
Obsoletos.
Cierra el marco de edición de plantillas activo actualmente después de guardar los cambios pertinentes. (Heredado de TemplatedControlDesigner) |
| GetBounds() |
Recupera las coordenadas del rectángulo que representa los límites del control tal como se muestra en la superficie de diseño. (Heredado de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsoletos.
Obtiene los verbos de edición de plantillas almacenadas en caché disponibles para el diseñador. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Genera un objeto que se puede usar como origen de datos en tiempo de diseño. (Heredado de BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Genera un objeto que se puede usar como origen de datos en tiempo de diseño. (Heredado de BaseDataListDesigner) |
| GetDesignTimeHtml() |
Obtiene el marcado HTML usado para representar el DataGrid control en tiempo de diseño. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera el marcado HTML para mostrar el control y rellena la colección con las regiones actuales del diseñador de controles. (Heredado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Devuelve el contenido de una región editable de la vista en tiempo de diseño del control asociado. (Heredado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Obtiene el marcado HTML usado para representar un control vacío basado en plantillas en tiempo de diseño. |
| GetErrorDesignTimeHtml(Exception) |
Obtiene el marcado HTML mostrado en tiempo de diseño para la excepción especificada cuando se ha encontrado un error al representar el control. |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetPersistenceContent() |
Recupera el marcado HTML interno persistente del control en tiempo de diseño. (Heredado de ControlDesigner) |
| GetPersistInnerHtml() |
Obtiene el marcado que se va a conservar para el contenido que se encuentra en el tiempo de ejecución del control de servidor asociado. (Heredado de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtiene el componente de origen de datos del contenedor de control asociado, resuelto en un miembro de datos específico. (Heredado de BaseDataListDesigner) |
| GetSelectedDataSource() |
Obtiene el componente de origen de datos del contenedor de control asociado. (Heredado de BaseDataListDesigner) |
| GetService(Type) |
Intenta recuperar el tipo de servicio especificado del sitio del modo de diseño del componente del diseñador. (Heredado de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsoletos.
Obtiene la propiedad de elemento de datos del contenedor de plantillas. |
| GetTemplateContainerDataSource(String) |
Obsoletos.
Obtiene el origen de datos del contenedor de la plantilla. (Heredado de BaseDataListDesigner) |
| GetTemplateContent(ITemplateEditingFrame, String, Boolean) |
Obsoletos.
Obtiene el contenido de la plantilla. |
| GetTemplateEditingVerbs() |
Obsoletos.
Obtiene los verbos de edición de plantillas disponibles para el diseñador. (Heredado de TemplatedControlDesigner) |
| GetTemplateFromText(String) |
Crea una plantilla a partir del texto especificado. (Heredado de TemplatedControlDesigner) |
| GetTemplatePropertyParentType(String) |
Obsoletos.
Obtiene el Type objeto correspondiente al elemento primario de la plantilla especificada. |
| GetTextFromTemplate(ITemplate) |
Obtiene una cadena de texto que representa la plantilla especificada. (Heredado de TemplatedControlDesigner) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetViewRendering() |
Recupera un objeto que contiene el marcado en tiempo de diseño para el contenido y las regiones del control asociado. (Heredado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa el diseñador con el control especificado DataGrid . |
| InitializeExistingComponent(IDictionary) |
Reinicializa un componente existente. (Heredado de ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicializa un componente recién creado. (Heredado de ComponentDesigner) |
| InitializeNonDefault() |
Obsoletos.
Inicializa la configuración de un componente importado que ya se ha inicializado en la configuración distinta de los valores predeterminados. (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 para volver 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 indica al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtiene del InheritanceAttribute objeto especificado ComponentDesigner. (Heredado de ComponentDesigner) |
| InvokePropertyBuilder(Int32) |
Invoca un editor de componentes para el control asociado. (Heredado de BaseDataListDesigner) |
| IsPropertyBound(String) |
Obsoletos.
Recupera un valor que indica si la propiedad especificada en el control asociado está enlazada a datos. (Heredado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Usa el escritor de recursos proporcionado para conservar las propiedades localizables del control asociado a un recurso en el host de diseño. (Heredado de ControlDesigner) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| OnAutoFormat(Object, EventArgs) |
Obsoletos.
Controla el |
| OnAutoFormatApplied(DesignerAutoFormat) |
Se llama cuando se ha aplicado un esquema de formato automático al control asociado. (Heredado de BaseDataListDesigner) |
| OnBehaviorAttached() |
Obsoletos.
Proporciona una oportunidad para realizar un procesamiento adicional cuando se adjunta un comportamiento al diseñador. (Heredado de TemplatedControlDesigner) |
| OnBehaviorDetaching() |
Obsoletos.
Se llama cuando un comportamiento desasocia del elemento . (Heredado de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoletos.
Se llama cuando cambia la colección de enlaces de 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) |
| OnColumnsChanged() |
Se llama cuando cambian las columnas de la plantilla. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Se llama cuando hay un cambio en el control asociado. (Heredado de BaseDataListDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa el método que controlará el ComponentChanging evento del control asociado. (Heredado de ControlDesigner) |
| OnControlResize() |
Obsoletos.
Se llama cuando se ha cambiado el tamaño del control de servidor web asociado en el host de diseño en tiempo de diseño. (Heredado de ControlDesigner) |
| OnDataSourceChanged() |
Se llama cuando el origen de datos del control asociado ha cambiado. (Heredado de BaseDataListDesigner) |
| OnPaint(PaintEventArgs) |
Se llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el CustomPaint valor es |
| OnPropertyBuilder(Object, EventArgs) |
Representa el método que controla el evento property-builder. (Heredado de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Se llama cuando cambia el esquema del origen de datos para el control asociado. (Heredado de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsoletos.
Establece las propiedades predeterminadas del componente. (Heredado de ComponentDesigner) |
| OnSetParent() |
Proporciona una oportunidad para realizar un procesamiento adicional cuando se cambia el elemento primario de este diseñador. (Heredado de TemplatedControlDesigner) |
| OnStylesChanged() |
Se puede invalidar para implementar la funcionalidad que debe producirse cuando ha cambiado un estilo del control asociado. (Heredado de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Se llama cuando cambian los verbos de edición de plantillas. |
| OnTemplateModeChanged() |
Proporciona una oportunidad para realizar un procesamiento adicional cuando se cambia el modo de plantilla. (Heredado de TemplatedControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permite que un diseñador cambie o quite elementos del conjunto de atributos que expone a través de .TypeDescriptor (Heredado de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permite que un diseñador cambie o quite elementos del conjunto de eventos que expone a través de .TypeDescriptor (Heredado de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permite que un diseñador cambie o quite elementos del conjunto de propiedades que expone a través de .TypeDescriptor (Heredado de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permite que un diseñador agregue al conjunto de atributos que expone a través de .TypeDescriptor (Heredado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Establece la lista de eventos que se exponen en tiempo de diseño para el TypeDescriptor objeto del componente. (Heredado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Usado por el diseñador para quitar propiedades de o agregar propiedades adicionales a la presentación en la cuadrícula Propiedades o a las propiedades de sombra del control asociado. (Heredado de BaseDataListDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica a IComponentChangeService que se ha cambiado este componente. (Heredado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica que IComponentChangeService este componente está a punto de cambiarse. (Heredado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoletos.
Genera el evento OnControlResize(). (Heredado de ControlDesigner) |
| RegisterClone(Object, Object) |
Registra datos internos en un control clonado. (Heredado de ControlDesigner) |
| SaveActiveTemplateEditingFrame() |
Guarda el marco de edición de plantillas activo. (Heredado de TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región editable del control en tiempo de diseño. (Heredado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región editable en la vista en tiempo de diseño del control. (Heredado de ControlDesigner) |
| SetTemplateContent(ITemplateEditingFrame, String, String) |
Obsoletos.
Establece el contenido de la plantilla y el marco especificados. |
| SetViewFlags(ViewFlags, Boolean) |
Asigna la enumeración bit a bit ViewFlags especificada al valor de marca especificado. (Heredado de ControlDesigner) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| UpdateDesignTimeHtml() |
Actualiza el CÓDIGO HTML en tiempo de diseño. (Heredado de TemplatedControlDesigner) |