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 servidor web DataGrid.
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
| DataGridDesigner() |
Inicializa una nueva instancia de la clase DataGridDesigner. |
Propiedades
| ActionLists |
Obtiene la colección de listas de acciones 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 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 el objeto DesignerAutoFormatCollection asociado a este diseñador. |
| AutoFormats |
Obtiene la colección de esquemas de formato automático predefinidos para mostrarla en tiempo de diseño en el cuadro de diálogo Formato automático correspondiente al control asociado. (Heredado de ControlDesigner) |
| 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 permite ver o editar plantillas. (Heredado de TemplatedControlDesigner) |
| 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 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 de miembro de datos del control asociado. (Heredado de BaseDataListDesigner) |
| DataSource |
Obtiene o establece el valor de la propiedad del 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 de id. del origen de datos, y se utiliza para realizar una copia sombra de la propiedad correspondiente del control asociado. (Heredado de BaseDataListDesigner) |
| DesignerState |
Obtiene un objeto que se utiliza para guardar 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 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 |
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 en tiempo de diseño para el control actual. (Heredado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Obtiene un valor que indica si las propiedades del control estarán ocultas cuando el control se encuentre en modo de edición de plantillas. (Heredado de TemplatedControlDesigner) |
| 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 |
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 sólo lectura en tiempo de diseño. (Heredado de ControlDesigner) |
| RootDesigner |
Obtiene el diseñador de controles para la página de formularios Web Forms que contiene el control asociado. (Heredado de ControlDesigner) |
| SetTextualDefaultProperty |
Extiende el comportamiento en tiempo de diseño para el control de servidor web DataGrid. (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; cada uno de ellos contiene una definición de plantilla. (Heredado de TemplatedControlDesigner) |
| UsePreviewControl |
Obtiene un valor que indica si el diseñador de control utiliza 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 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
| 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) |
| CreateTemplateEditingFrame(TemplateEditingVerb) |
Obsoletos.
Crea un marco de edición de plantillas utilizando el verbo especificado. |
| 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 que usa el objeto DataGridDesigner y libera los recursos administrados de forma opcional. |
| 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) |
| EnterTemplateMode(ITemplateEditingFrame) |
Obsoletos.
Abre un objeto de marco de plantilla concreto para editarlo en el diseñador. (Heredado de TemplatedControlDesigner) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| ExitTemplateMode(Boolean, Boolean, Boolean) |
Obsoletos.
Cierra el marco de edición de plantillas actualmente activo después de guardar los cambios relevantes. (Heredado de TemplatedControlDesigner) |
| GetBounds() |
Recupera las coordenadas del rectángulo que representa los límites del control mostrado en la superficie de diseño. (Heredado de ControlDesigner) |
| GetCachedTemplateEditingVerbs() |
Obsoletos.
Obtiene los verbos de edición de plantillas almacenados en caché que se encuentran disponibles para el diseñador. |
| GetDesignTimeDataSource(IEnumerable, Int32, Boolean) |
Genera un objeto que se puede utilizar como origen de datos en tiempo de diseño. (Heredado de BaseDataListDesigner) |
| GetDesignTimeDataSource(Int32, Boolean) |
Genera un objeto que se puede utilizar como origen de datos en tiempo de diseño. (Heredado de BaseDataListDesigner) |
| GetDesignTimeHtml() |
Obtiene el formato HTML que se utiliza para representar el control DataGrid en tiempo de diseño. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera el formato 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 modificable de la vista en tiempo de diseño del control asociado. (Heredado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Obtiene el código HTML que se utiliza para representar un control vacío basado en plantillas en tiempo de diseño. |
| GetErrorDesignTimeHtml(Exception) |
Obtiene el código HTML que se muestra en tiempo de diseño para la excepción especificada cuando se detecta un error al representarse el control. |
| 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() |
Obtiene el marcado que se ha de conservar para el contenido que está en el motor en tiempo de ejecución del control de servidor asociado. (Heredado de TemplatedControlDesigner) |
| GetResolvedSelectedDataSource() |
Obtiene el componente de origen de datos desde el contenedor de control asociado, resuelto en un miembro de datos concreto. (Heredado de BaseDataListDesigner) |
| GetSelectedDataSource() |
Obtiene el componente de origen de datos del contenedor del control asociado. (Heredado de BaseDataListDesigner) |
| GetService(Type) |
Intenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador. (Heredado de ComponentDesigner) |
| GetTemplateContainerDataItemProperty(String) |
Obsoletos.
Obtiene la propiedad del 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 que se encuentran 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 objeto Type 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 formato 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 DataGrid especificado. |
| 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) |
| 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 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) |
| OnAutoFormat(Object, EventArgs) |
Obsoletos.
Controla el evento |
| 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 de realizar procesos adicionales cuando hay un comportamiento conectado al diseñador. (Heredado de TemplatedControlDesigner) |
| 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) |
| OnColumnsChanged() |
Se invoca cuando cambian las columnas de la plantilla. |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Se llama a este método cuando hay un cambio en el control asociado. (Heredado de BaseDataListDesigner) |
| 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) |
| OnDataSourceChanged() |
Se llama cuando ha cambiado el origen de datos del control asociado. (Heredado de BaseDataListDesigner) |
| 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 |
| OnPropertyBuilder(Object, EventArgs) |
Representa el método que controla el evento del generador de propiedades. (Heredado de BaseDataListDesigner) |
| OnSchemaRefreshed() |
Se llama cuando cambia el esquema del origen de datos correspondiente al control asociado. (Heredado de BaseDataListDesigner) |
| OnSetComponentDefaults() |
Obsoletos.
Obsoletos.
Establece las propiedades predeterminadas del componente. (Heredado de ComponentDesigner) |
| OnSetParent() |
Proporciona una oportunidad de realizar procesos adicionales cuando cambia el elemento principal de este diseñador. (Heredado de TemplatedControlDesigner) |
| OnStylesChanged() |
Se puede reemplazar para implementar funcionalidad que es necesaria cuando ha cambiado un estilo del control asociado. (Heredado de BaseDataListDesigner) |
| OnTemplateEditingVerbsChanged() |
Se invoca cuando cambian los verbos de edición de plantillas. |
| OnTemplateModeChanged() |
Proporciona una oportunidad de realizar procesos adicionales cuando cambia el modo de plantilla. (Heredado de TemplatedControlDesigner) |
| 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. (Heredado de BaseDataListDesigner) |
| 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) |
| SaveActiveTemplateEditingFrame() |
Guarda el marco de edición de plantillas activo. (Heredado de TemplatedControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región modificable del control en tiempo de diseño. (Heredado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región modificable 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 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 código HTML en tiempo de diseño. (Heredado de TemplatedControlDesigner) |
