DataGridDesigner Clase

Definición

Espacio de nombres:

System.Web.UI.Design.WebControls

Ensamblado:

System.Design.dll

Extiende el comportamiento en tiempo de diseño para el control de DataGrid servidor web.

public ref class DataGridDesigner : System::Web::UI::Design::WebControls::BaseDataListDesigner

[System.Web.UI.Design.SupportsPreviewControl(true)]
public class DataGridDesigner : System.Web.UI.Design.WebControls.BaseDataListDesigner

[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type DataGridDesigner = class
    inherit BaseDataListDesigner

Public Class DataGridDesigner
Inherits BaseDataListDesigner

Herencia

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

TemplatedControlDesigner

BaseDataListDesigner

DataGridDesigner

Atributos

SupportsPreviewControlAttribute

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)
Expressions	Obtiene los enlaces de expresión para el control actual en tiempo de diseño. (Heredado de HtmlControlDesigner)
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)
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 View control para mostrarlo en la superficie de diseño. (Heredado de ControlDesigner)
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)
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 AutoFormat evento. (Heredado de BaseDataListDesigner)
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 true. (Heredado de ControlDesigner)
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)

Implementaciones de interfaz explícitas

Nombre	Description
IDataBindingSchemaProvider.CanRefreshSchema	Para obtener una descripción de este miembro, vea CanRefreshSchema. (Heredado de BaseDataListDesigner)
IDataBindingSchemaProvider.RefreshSchema(Boolean)	Para obtener una descripción de este miembro, vea RefreshSchema(Boolean). (Heredado de BaseDataListDesigner)
IDataBindingSchemaProvider.Schema	Para obtener una descripción de este miembro, vea Schema. (Heredado de BaseDataListDesigner)
IDesignerFilter.PostFilterAttributes(IDictionary)	Para obtener una descripción de este miembro, consulte el PostFilterAttributes(IDictionary) método . (Heredado de ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Para obtener una descripción de este miembro, consulte el PostFilterEvents(IDictionary) método . (Heredado de ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Para obtener una descripción de este miembro, consulte el PostFilterProperties(IDictionary) método . (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Para obtener una descripción de este miembro, consulte el PreFilterAttributes(IDictionary) método . (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Para obtener una descripción de este miembro, consulte el PreFilterEvents(IDictionary) método . (Heredado de ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Para obtener una descripción de este miembro, consulte el PreFilterProperties(IDictionary) método . (Heredado de ComponentDesigner)
ITreeDesigner.Children	Para obtener una descripción de este miembro, vea la Children propiedad . (Heredado de ComponentDesigner)
ITreeDesigner.Parent	Para obtener una descripción de este miembro, vea la Parent propiedad . (Heredado de ComponentDesigner)

Consulte también

• DataGrid
• DataGridComponentEditor
• Información general sobre el control de servidor web GridView
• Extensión de la compatibilidad con Design-Time
• Cómo: Ampliar la apariencia y el comportamiento de los controles en modo de diseño