DetailsViewDesigner Classe

Définition

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

Héritage

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

DetailsViewDesigner

Exemples

L’exemple de code suivant montre comment étendre la DetailsViewDesigner classe pour modifier l’apparence des contrôles dérivés du contrôle au moment du DetailsView design.

L’exemple dérive le MyDetailsView contrôle de .DetailsView est MyDetailsView simplement une copie du DetailsView contrôle. L’exemple dérive également la MyDetailsViewDesigner classe de DetailsViewDesigner et place un DesignerAttribute objet pour MyDetailsViewDesigner sur le MyDetailsView contrôle .

The MyDetailsViewDesigner remplace la SampleRowCount propriété pour spécifier que la ligne de pagineur de l’affichage au moment du design du contient cinq liens de MyDetailsView page. Elle remplace la PreFilterProperties méthode pour rendre la NamingContainer propriété visible dans la grille Property au moment du design. Il remplace la GetDesignTimeHtml méthode pour inclure la Caption propriété, si elle est spécifiée, en tant que nouvelle première ligne dans la grille au moment du MyDetailsView design. Si la BorderStyle propriété du MyDetailsView est la NotSet valeur ou None , dessine GetDesignTimeHtml une bordure en pointillés bleus autour du contrôle pour rendre son étendue plus 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 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

Remarques

Dans un concepteur visuel, lorsque vous passez du mode Source au mode Création, le code source de balisage qui décrit le DetailsView contrôle est analysé et une version au moment du design du contrôle est créée sur l’aire de conception. Lorsque vous revenez à la vue Source, le contrôle au moment du design est conservé dans le code source du balisage et modifié dans le balisage de la page Web.

Les propriétés de la DetailsViewDesigner classe fournissent les fonctionnalités suivantes :

• La ActionLists propriété retourne un DesignerActionListCollection objet, qui contient généralement un objet dérivé de la DesignerActionList classe pour chaque niveau de l’arborescence d’héritage du concepteur.

• La AutoFormats propriété renvoie une collection de schémas de mise en forme à afficher dans la boîte de dialogue Mise en forme automatique.

• La TemplateGroups propriété retourne une collection de groupes de modèles pour les champs du contrôle associé DetailsView et les modèles de niveau DetailsView supérieur.

• La UsePreviewControl propriété retourne truetoujours , indiquant que le concepteur crée une copie temporaire du contrôle associé DetailsView pour générer le balisage au moment du design.

Les DetailsViewDesigner méthodes de classe fournissent les fonctionnalités suivantes :

• La DataBind méthode lie le contrôle associé DetailsView à une source de données au moment du design.

• La GetDesignTimeHtml méthode retourne le balisage utilisé pour afficher le associé DetailsView au moment du design.

• La Initialize méthode prépare le concepteur à afficher, modifier et concevoir le associé DetailsView.

• La OnClick méthode est appelée lorsqu’on clique sur une région de l’affichage au moment de la conception de l’associé DetailsView .

• La OnSchemaRefreshed méthode est appelée lorsque le schéma de la source de données des modifications associées DetailsView .

• La PreFilterProperties méthode est utilisée pour supprimer ou ajouter des propriétés supplémentaires ou pour les propriétés d’ombre du associé DetailsView.

Les régions modifiables au moment du design ne sont pas prises en charge dans le DetailsView contrôle, de sorte que les GetEditableDesignerRegionContent méthodes et SetEditableDesignerRegionContent n’ont aucune fonctionnalité.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• DetailsView
• DataBoundControlDesigner
• Présentation des concepteurs de contrôles ASP.NET
• Procédure pas à pas : création d’un concepteur de contrôles de base pour un contrôle serveur web