DetailsViewDesigner Klas

Definitie

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

Overname

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

DetailsViewDesigner

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de DetailsViewDesigner klasse kunt uitbreiden om het uiterlijk van besturingselementen te wijzigen die zijn afgeleid van het besturingselement tijdens het DetailsView ontwerp.

In het voorbeeld wordt het MyDetailsView besturingselement afgeleid van de DetailsView. Het MyDetailsView is gewoon een kopie van het DetailsView besturingselement. In het voorbeeld wordt ook de MyDetailsViewDesigner klasse afgeleid van DetailsViewDesigner en wordt een DesignerAttribute object voor MyDetailsViewDesigner het MyDetailsView besturingselement geplaatst.

The MyDetailsViewDesigner overschrijft de SampleRowCount eigenschap om op te geven dat de paginarij van de ontwerptijdweergave van de weergave MyDetailsView vijf paginakoppelingen bevat. De methode wordt overschreven PreFilterProperties om de NamingContainer eigenschap zichtbaar te maken in het eigenschappenraster tijdens het ontwerp. De methode wordt overschreven om de GetDesignTimeHtmlCaption eigenschap op te nemen, als deze is opgegeven, als een nieuwe eerste rij in het raster tijdens het MyDetailsView ontwerp. Als de eigenschap van de BorderStyle eigenschap de MyDetailsViewNotSet of None waarde is, tekent de GetDesignTimeHtml blauwe stippelrand rond het besturingselement om de omvang beter zichtbaar te maken.

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

Opmerkingen

Wanneer u in een visuele ontwerper overschakelt van de bronweergave naar de ontwerpweergave, wordt de broncode voor markeringen die het DetailsView besturingselement beschrijft geparseerd en wordt er een ontwerptijdversie van het besturingselement gemaakt op het ontwerpoppervlak. Wanneer u terugschakelt naar de bronweergave, blijft het ontwerptijdbesturingselement behouden om de broncode van markeringen te markeren en bewerkt in de markeringen voor de webpagina.

De eigenschappen van de DetailsViewDesigner klasse bieden de volgende functionaliteit:

• De ActionLists eigenschap retourneert een DesignerActionListCollection object, dat meestal een object bevat dat is afgeleid van de DesignerActionList klasse voor elk niveau in de overnamestructuur van de ontwerper.

• De AutoFormats eigenschap retourneert een verzameling opmaakschema's voor weergave in het dialoogvenster Automatische opmaak .

• De TemplateGroups eigenschap retourneert een verzameling sjabloongroepen voor de velden van het gekoppelde DetailsView besturingselement en de sjablonen op het hoogste niveau DetailsView .

• De UsePreviewControl eigenschap retourneert truealtijd, waarmee wordt aangegeven dat de ontwerper een tijdelijke kopie van het bijbehorende DetailsView besturingselement maakt om de ontwerptijdmarkeringen te genereren.

De DetailsViewDesigner klassemethoden bieden de volgende functionaliteit:

• De DataBind methode verbindt het bijbehorende DetailsView besturingselement met een ontwerptijdgegevensbron.

• De GetDesignTimeHtml methode retourneert de markeringen die worden gebruikt om de bijbehorende DetailsView markeringen weer te geven tijdens het ontwerp.

• De Initialize methode bereidt de ontwerpfunctie voor om de bijbehorende DetailsViewitems weer te geven, te bewerken en te ontwerpen.

• De OnClick methode wordt aangeroepen wanneer op een gebied van de ontwerptijdweergave van de bijbehorende DetailsView weergave wordt geklikt.

• De OnSchemaRefreshed methode wordt aangeroepen wanneer het schema van de gegevensbron van de gekoppelde wijzigingen wordt aangeroepen DetailsView .

• De PreFilterProperties methode wordt gebruikt om extra eigenschappen of schaduweigenschappen van de bijbehorende DetailsVieweigenschappen te verwijderen of toe te voegen.

Ontwerp-tijd bewerkbare regio's worden niet ondersteund in het DetailsView besturingselement, dus de GetEditableDesignerRegionContent en SetEditableDesignerRegionContent methoden hebben geen functionaliteit.

Zie ook

• DetailsView
• DataBoundControlDesigner
• Toegang tot ASP.NET Besturingsontwerpers
• Overzicht: Een eenvoudige ontwerpfunctie voor besturingselementen maken voor een webserverbesturing