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 a seguir mostra como estender a GridViewDesigner classe para alterar a aparência dos controles derivados do GridView controle em tempo de design.

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

O MyGridViewDesigner substitui o PreFilterProperties método para tornar a Page propriedade visível na grade Propriedades em tempo de design. Ele substitui o GetDesignTimeHtml método para incluir a Caption propriedade , se for especificada, como uma nova primeira linha no MyGridView controle em tempo de design. Se a BorderStyle propriedade do MyGridView controle tiver o NotSet valor ou None , o GetDesignTimeHtml desenhará uma borda tracejada azul ao redor do controle para tornar 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

Comentários

Em um designer visual, quando você alterna do modo Fonte para Design, o código-fonte de marcação que descreve o GridView controle é analisado e uma versão em tempo de design do controle é criada na superfície de design. Quando você volta para o Modo de Exibição de origem, o controle de tempo de design é persistido para o código-fonte de marcação e editado na marcação da página da Web.

As propriedades da GridViewDesigner classe fornecem a seguinte funcionalidade:

• A ActionLists propriedade retorna 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 retorna uma coleção de esquemas de formatação para exibição na caixa de diálogo Formato Automático .

• A TemplateGroups propriedade retorna uma coleção de grupos de modelos para os campos do controle associado GridView e os modelos de nível GridView superior.

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

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

• O DataBind método associa o controle associado GridView a uma fonte de dados em tempo de design.

• O GetDesignTimeHtml método retorna a marcação usada para renderizar o associado GridView em tempo de design.

• O Initialize método prepara o designer para exibir, editar e projetar o associado GridView.

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

• O OnSchemaRefreshed método é chamado quando o esquema da fonte de dados do associado GridView é alterado.

• O PreFilterProperties método é usado para remover ou adicionar propriedades ou para sombrear propriedades do associado GridView.

Não há suporte para regiões editáveis em tempo de design no GridView controle , portanto, os GetEditableDesignerRegionContent métodos e SetEditableDesignerRegionContent não têm funcionalidade.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

• GridView
• DataBoundControlDesigner
• Introdução aos Designers de Controle de ASP.NET
• Passo a passo: criando um controle básico Designer para um controle de servidor Web