DetailsViewDesigner Classe

Definição

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

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

type DetailsViewDesigner = class
    inherit DataBoundControlDesigner

Public Class DetailsViewDesigner
Inherits DataBoundControlDesigner

Herança

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

DetailsViewDesigner

Exemplos

O exemplo de código a seguir mostra como estender a DetailsViewDesigner classe para alterar a aparência dos controles derivados do DetailsView controle em tempo de design.

O exemplo deriva o MyDetailsView controle do DetailsView. O MyDetailsView é simplesmente uma cópia do DetailsView controle . O exemplo também deriva a MyDetailsViewDesigner classe de DetailsViewDesigner e coloca um DesignerAttribute objeto para MyDetailsViewDesigner no MyDetailsView controle .

The MyDetailsViewDesigner substitui a SampleRowCount propriedade para especificar que a linha pager do modo de exibição de tempo de design do MyDetailsView contém cinco links de página. Ele substitui o PreFilterProperties método para tornar a NamingContainer propriedade visível na grade Propriedade em tempo de design. Ele substitui o GetDesignTimeHtml método para incluir a Caption propriedade , se for especificada, como uma nova primeira linha na MyDetailsView grade em tempo de design. Se a BorderStyle propriedade do MyDetailsView for 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 MyDetailsView is a copy of the DetailsView.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyDetailsViewDesigner))]
    public class MyDetailsView : DetailsView
    {
    } // MyDetailsView

    // Override members of the DetailsViewDesigner.
    [ReflectionPermission(SecurityAction.Demand, Flags=ReflectionPermissionFlag.MemberAccess)]
    public class MyDetailsViewDesigner : DetailsViewDesigner
    {
        // Determines the number of page links in the pager row
        // when viewed in the designer.
        protected override int SampleRowCount
        {
            get
            {
                // Render five page links in the pager row.
                return 5;
            }
        } // SampleRowCount

        // Shadow the control properties with design-time properties.
        protected override void PreFilterProperties(IDictionary properties)
        {
            // Call the base method first.
            base.PreFilterProperties(properties);

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

        // Generate the design-time markup.
        const string capTag = "caption";
        const string trOpen = "tr><td colspan=2 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.
            MyDetailsView myDV = (MyDetailsView)Component;
            string markup = null;
            int charX;

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

                // Set design-time properties and catch any exceptions.
                try
                {
                    myDV.BorderStyle = BorderStyle.Dashed;
                    myDV.BorderWidth = Unit.Pixel(3);
                    myDV.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.
                    myDV.BorderStyle = oldBorderStyle;
                    myDV.BorderWidth = oldBorderWidth;
                    myDV.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=2 align=center".
                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
    } // MyDetailsViewDesigner
} // 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 MyDetailsView is a copy of the DetailsView.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyDetailsViewDesigner))> _
    Public Class MyDetailsView
        Inherits DetailsView
    End Class

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

        ' Determines the number of page links in the pager row
        ' when viewed in the designer.
        Protected Overrides ReadOnly Property SampleRowCount() As Integer
            Get
                ' Render five page links in the pager row.
                Return 5
            End Get
        End Property ' SampleRowCount

        ' 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 NamingContainer visible in the Properties grid.
            Dim selectProp As PropertyDescriptor = _
                CType(properties("NamingContainer"), PropertyDescriptor)
            properties("NamingContainer") = _
                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=2 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 myDV As MyDetailsView = CType(Component, MyDetailsView)
            Dim markup As String = Nothing
            Dim charX As Integer

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

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

                ' Set design-time properties and catch any exceptions.
                Try
                    myDV.BorderStyle = BorderStyle.Dashed
                    myDV.BorderWidth = Unit.Pixel(3)
                    myDV.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.
                    myDV.BorderStyle = oldBorderStyle
                    myDV.BorderWidth = oldBorderWidth
                    myDV.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=2 align=center".
                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 DetailsView 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 é persistente para marcar o código-fonte e editado na marcação da página da Web.

As propriedades da DetailsViewDesigner 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 DetailsView e os modelos de nível DetailsView superior.

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

Os DetailsViewDesigner métodos de classe fornecem a seguinte funcionalidade:

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

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

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

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

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

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

Não há suporte para regiões editáveis em tempo de design no DetailsView 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

• DetailsView
• 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