GridViewDesigner Classe

Definição

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

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

GridViewDesigner

Exemplos

O exemplo de código seguinte mostra como estender a GridViewDesigner classe para alterar a aparência dos controlos derivados do GridView controlo no momento do projeto.

O exemplo deriva o MyGridView controlo a partir do GridView. O MyGridView é simplesmente uma cópia do GridView. O exemplo também deriva a MyGridViewDesigner classe a partir da GridViewDesigner classe e coloca um DesignerAttribute objeto para o MyGridViewDesigner no MyGridView controlo.

Sobrepõe-se MyGridViewDesigner ao PreFilterProperties método para tornar a Page propriedade visível na grelha de Propriedades no momento do projeto. Sobrepõe-se ao GetDesignTimeHtml método para incluir a Caption propriedade, se for especificada, como uma nova primeira linha no MyGridView controlo no momento do projeto. Se a BorderStyle propriedade do MyGridView controlo tiver o NotSet valor ou None , desenha GetDesignTimeHtml uma borda azul tracejada à volta do controlo para tornar a sua extensão mais visível.

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

Observações

Num designer visual, quando se muda da vista de Fonte para a vista de Design, o código-fonte de marcação que descreve o GridView controlo é analisado e uma versão em tempo de design do controlo é criada na superfície de design. Quando regressa à vista Source, o controlo de tempo de design é mantido no código-fonte da marcação e editado na marcação da página Web.

As propriedades da GridViewDesigner classe fornecem a seguinte funcionalidade:

• A ActionLists propriedade devolve um DesignerActionListCollection objeto, que normalmente contém um objeto derivado da DesignerActionList classe para cada nível na árvore de herança do designer.

• A AutoFormats propriedade devolve uma coleção de esquemas de formatação para mostrar na caixa de diálogo Formatar Automaticamente .

• A TemplateGroups propriedade devolve uma coleção de grupos de templates para os campos do controlo associado GridView e dos templates de topo GridView .

• A UsePreviewControl propriedade devolve truesempre , indicando que o designer cria uma cópia temporária do associado GridView para gerar a marcação em tempo de design.

Os métodos da GridViewDesigner classe fornecem a seguinte funcionalidade:

• O DataBind método vincula o controlo associado GridView a uma fonte de dados em tempo de projeto.

• O GetDesignTimeHtml método devolve a marcação que é usada para renderizar a associada GridView no momento do design.

• O Initialize método prepara o designer para visualizar, editar e desenhar o .GridView

• O OnClick método é chamado quando uma região da vista em tempo de design do associado GridView é clicada.

• O OnSchemaRefreshed método é chamado quando o esquema da fonte de dados associada GridView muda.

• O PreFilterProperties método é usado para remover ou adicionar propriedades ou para propriedades de sombra do .GridView

Regiões editáveis em tempo de design não são suportadas no GridView controlo, pelo que os GetEditableDesignerRegionContent métodos and SetEditableDesignerRegionContent não têm funcionalidade.

Ver também

• GridView
• DataBoundControlDesigner
• Introdução aos Designers de Controlo ASP.NET
• Guia: Criar um Designer Básico de Controlo para um Controlo de Servidor Web