GridViewDesigner Clase

Definición

public ref class GridViewDesigner : System::Web::UI::Design::WebControls::DataBoundControlDesigner

public class GridViewDesigner : System.Web.UI.Design.WebControls.DataBoundControlDesigner

type GridViewDesigner = class
    inherit DataBoundControlDesigner

Public Class GridViewDesigner
Inherits DataBoundControlDesigner

Herencia

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

GridViewDesigner

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la GridViewDesigner clase para cambiar la apariencia de los controles derivados del GridView control en tiempo de diseño.

En el ejemplo se deriva el MyGridView control de GridView. es MyGridView simplemente una copia de .GridView En el ejemplo también se deriva la MyGridViewDesigner clase de la GridViewDesigner clase y se coloca un DesignerAttribute objeto para en MyGridViewDesigner el MyGridView control .

MyGridViewDesigner Invalida el PreFilterProperties método para que la Page propiedad sea visible en la cuadrícula Propiedades en tiempo de diseño. Reemplaza el GetDesignTimeHtml método para incluir la Caption propiedad , si se especifica, como una nueva primera fila del MyGridView control en tiempo de diseño. Si la BorderStyle propiedad del MyGridView control tiene el NotSet valor o None , GetDesignTimeHtml dibuja un borde discontinuo azul alrededor del control para que su extensión sea más visible.

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 MyGridView is a copy of the GridView.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyGridViewDesigner))]
    public class MyGridView : GridView
    {
    } // MyGridView

    // Override members of the GridViewDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyGridViewDesigner : GridViewDesigner
    {
        // Shadow the control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            // Call the base method first.
            base.PreFilterProperties(properties);

            // Make the Page visible in the Properties grid.
            PropertyDescriptor selectProp = 
                (PropertyDescriptor)properties["Page"];
            properties["Page"] =
                TypeDescriptor.CreateProperty(selectProp.ComponentType, 
                    selectProp, BrowsableAttribute.Yes);
        } // PreFilterProperties

        // Generate the design-time markup.
        const string capTag = "caption";
        const string trOpen = "tr><td colspan=9 align=center";
        const string trClose = "td></tr";

        public override string GetDesignTimeHtml()
        {
            // Make the full extent of the control more visible in the designer.
            // If the border style is None or NotSet, change the border to
            // a wide, blue, dashed line. Include the caption within the border.
            MyGridView myGV = (MyGridView)Component;
            string markup = null;
            int charX;

            // Check if the border style should be changed.
            if (myGV.BorderStyle == BorderStyle.NotSet ||
                myGV.BorderStyle == BorderStyle.None)
            {
                BorderStyle oldBorderStyle = myGV.BorderStyle;
                Unit oldBorderWidth = myGV.BorderWidth;
                Color oldBorderColor = myGV.BorderColor;

                // Set the design-time properties and catch any exceptions.
                try
                {
                    myGV.BorderStyle = BorderStyle.Dashed;
                    myGV.BorderWidth = Unit.Pixel(3);
                    myGV.BorderColor = Color.Blue;

                    // Call the base method to generate the markup.
                    markup = base.GetDesignTimeHtml();
                }
                catch (Exception ex)
                {
                    markup = GetErrorDesignTimeHtml(ex);
                }
                finally
                {
                    // Restore the properties to their original settings.
                    myGV.BorderStyle = oldBorderStyle;
                    myGV.BorderWidth = oldBorderWidth;
                    myGV.BorderColor = oldBorderColor;
                }
            }
            else
            {
                // Call the base method to generate the markup.
                markup = base.GetDesignTimeHtml();
            }

            // Look for a <caption> tag.
            if ((charX = markup.IndexOf(capTag)) > 0)
            {
                // Replace the first caption with 
                // "tr><td colspan=9 align=center".
                // It is okay if the colspan exceeds the 
                // number of columns in the table.
                markup = markup.Remove(charX,
                    capTag.Length).Insert(charX, trOpen);

                // Replace the second caption with "td></tr".
                if ((charX = markup.IndexOf(capTag, charX)) > 0)
                    markup = markup.Remove(charX,
                        capTag.Length).Insert(charX, trClose);
            }
            return markup;
        } // GetDesignTimeHtml
    } // MyGridViewDesigner
} // 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 MyGridView is a copy of the GridView.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyGridViewDesigner))> _
    Public Class MyGridView
        Inherits GridView
    End Class

    ' Override members of the GridViewDesigner.
    <ReflectionPermission(SecurityAction.Demand, Flags:=ReflectionPermissionFlag.MemberAccess)> _
    Public Class MyGridViewDesigner
        Inherits GridViewDesigner

        ' 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 Page visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("Page"), PropertyDescriptor)
            properties("Page") = _
                TypeDescriptor.CreateProperty(selectProp.ComponentType, _
                    selectProp, BrowsableAttribute.Yes)
        End Sub

        ' Generate the design-time markup.
        Private Const capTag As String = "caption"
        Private Const trOpen As String = "tr><td colspan=9 align=center"
        Private Const trClose As String = "td></tr"

        Public Overrides Function GetDesignTimeHtml() As String

            ' Make the full extent of the control more visible in the designer.
            ' If the border style is None or NotSet, change the border to
            ' a wide, blue, dashed line. Include the caption within the border.
            Dim myGV As MyGridView = CType(Component, MyGridView)
            Dim markup As String = Nothing
            Dim charX As Integer

            ' Check if the border style should be changed.
            If (myGV.BorderStyle = BorderStyle.NotSet Or _
                myGV.BorderStyle = BorderStyle.None) Then

                Dim oldBorderStyle As BorderStyle = myGV.BorderStyle
                Dim oldBorderWidth As Unit = myGV.BorderWidth
                Dim oldBorderColor As Color = myGV.BorderColor

                ' Set the design-time properties and catch any exceptions.
                Try
                    myGV.BorderStyle = BorderStyle.Dashed
                    myGV.BorderWidth = Unit.Pixel(3)
                    myGV.BorderColor = Color.Blue

                    ' Call the base method to generate the markup.
                    markup = MyBase.GetDesignTimeHtml()

                Catch ex As Exception
                    markup = GetErrorDesignTimeHtml(ex)

                Finally
                    ' Restore the properties to their original settings.
                    myGV.BorderStyle = oldBorderStyle
                    myGV.BorderWidth = oldBorderWidth
                    myGV.BorderColor = oldBorderColor
                End Try

            Else
                ' Call the base method to generate the markup.
                markup = MyBase.GetDesignTimeHtml()
            End If

            ' Look for a <caption> tag.
            charX = markup.IndexOf(capTag)
            If charX > 0 Then

                ' Replace the first caption with 
                ' "tr><td colspan=9 align=center".
                ' It is okay if the colspan exceeds the 
                ' number of columns in the table.
                markup = markup.Remove(charX, _
                    capTag.Length).Insert(charX, trOpen)

                ' Replace the second caption with "td></tr".
                charX = markup.IndexOf(capTag, charX)
                If charX > 0 Then
                    markup = markup.Remove(charX, _
                        capTag.Length).Insert(charX, trClose)
                End If
            End If

            Return markup

        End Function ' GetDesignTimeHtml
    End Class
End Namespace ' Examples.VB.WebControls.Design

Comentarios

En un diseñador visual, al cambiar de la vista Origen a Diseño, el código fuente de marcado que describe el GridView 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.

Las propiedades de la GridViewDesigner 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 GridView y las plantillas de nivel GridView superior.

• La UsePreviewControl propiedad siempre devuelve true, lo que indica que el diseñador crea una copia temporal del asociado GridView para generar el marcado en tiempo de diseño.

Los métodos de la GridViewDesigner clase proporcionan la siguiente funcionalidad:

• El DataBind método enlaza el control asociado GridView a un origen de datos en tiempo de diseño.

• El GetDesignTimeHtml método devuelve el marcado que se usa para representar el asociado GridView en tiempo de diseño.

• El Initialize método prepara al diseñador para ver, editar y diseñar el asociado GridView.

• Se OnClick llama al método cuando se hace clic en una región de la vista en tiempo de diseño del asociado GridView .

• Se OnSchemaRefreshed llama al método cuando cambia el esquema del origen de datos de los cambios asociados GridView .

• El PreFilterProperties método se usa para quitar o agregar propiedades o para sombras de las propiedades asociadas GridView.

Las regiones editables en tiempo de diseño no se admiten en el GridView control, por lo que los GetEditableDesignerRegionContent métodos y SetEditableDesignerRegionContent no tienen ninguna funcionalidad.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• GridView
• DataBoundControlDesigner
• Introducción a los diseñadores de controles de ASP.NET
• Tutorial: Crear un control básico Designer para un control de servidor web