FormViewDesigner Klass

Definition

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

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

type FormViewDesigner = class
    inherit DataBoundControlDesigner

Public Class FormViewDesigner
Inherits DataBoundControlDesigner

Arv

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

FormViewDesigner

Exempel

I följande kodexempel visas hur du utökar FormViewDesigner klassen för att ändra utseendet på kontroller som härleds från FormView kontrollen vid designtillfället.

Exemplet härleder MyFormView kontrollen från FormView kontrollen. MyFormView är helt enkelt en kopia av FormView. Exemplet härleder MyFormViewDesigner även klassen från FormViewDesigner och placerar ett DesignerAttribute objekt för MyFormViewDesigner på MyFormView kontrollen.

Åsidosätter MyFormViewDesigner följande objekt:

• Egenskapen SampleRowCount för att ange att pager-raden för designtidsvyn MyFormView för innehåller fyra sidlänkar.

• Metoden GetDesignTimeHtml för att inkludera Caption egenskapen, om den anges, som en ny första rad i rutnätet MyFormView vid designtillfället. BorderStyle Om egenskapen MyFormView för är NotSet eller-värdet None ritar de GetDesignTimeHtml en blå streckad kantlinje runt kontrollen för att göra dess omfattning mer synlig.

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 MyFormView is a copy of the FormView.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyFormViewDesigner))]
    public class MyFormView : FormView
    {
    } // MyFormView

    // Override members of the FormViewDesigner.
    public class MyFormViewDesigner : FormViewDesigner
    {
        // Determines the number of design-time links in the pager row.
        protected override int SampleRowCount
        {
            get
            {
                // Render four links in the pager row.
                return 4;
            }
        } // SampleRowCount

        // 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.
            MyFormView myGV = (MyFormView)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
    } // MyFormViewDesigner
} // 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 MyFormView is a copy of the FormView.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyFormViewDesigner))> _
    Public Class MyFormView
        Inherits FormView
    End Class

    ' Override members of the FormViewDesigner.
    Public Class MyFormViewDesigner
        Inherits FormViewDesigner

        ' Determines the number of design-time links in the pager row.
        Protected Overrides ReadOnly Property SampleRowCount() As Integer
            Get
                ' Render four links in the pager row.
                Return 4
            End Get
        End Property ' SampleRowCount

        ' 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 MyFormView = CType(Component, MyFormView)
            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

Kommentarer

När du växlar från vyn Källa till Design i en visuell designer parsas källkoden FormView som beskriver kontrollen och en designtidsversion av kontrollen skapas på designytan. När du växlar tillbaka till källvyn sparas designtidskontrollen till källkoden för markering och redigeras till markering för webbsidan.

Egenskaperna för FormViewDesigner klassen ger följande funktioner:

• Egenskapen ActionLists returnerar ett DesignerActionListCollection objekt som vanligtvis innehåller ett objekt som härleds från DesignerActionList klassen för varje nivå i designerns arvsträd.

• Egenskapen AutoFormats returnerar en samling formateringsscheman för visning i dialogrutan Automatiskt format .

• Egenskapen TemplateGroups returnerar en samling mallgrupper för mallarna för den associerade FormView.

• Egenskapen UsePreviewControl returnerar truealltid , vilket anger att designern skapar en tillfällig kopia av den associerade FormView för att generera designtidsmarkeringen.

Klassmetoderna FormViewDesigner tillhandahåller följande funktioner:

• Metoden GetDesignTimeHtml returnerar den markering som används för att återge den associerade FormView vid designtillfället.

• Metoden Initialize förbereder designern för att visa, redigera och utforma den associerade FormView.

• Metoden OnSchemaRefreshed anropas när schemat för datakällan för de associerade FormView ändringarna.

Se även

• FormView
• DataBoundControlDesigner
• Introduction till ASP.NET Control Designers
• Genomgång: Skapa en grundläggande kontrolldesigner för en webbserverkontroll