FormViewDesigner クラス

.NET Framework クラス ライブラリ リファレンス

FormViewDesigner クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

FormView コントロールを、ビジュアル デザイナで、デザイン時に使用できるようにします。

名前空間: System.Web.UI.Design.WebControls
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Class FormViewDesigner
    Inherits DataBoundControlDesigner

Visual Basic (使用法)

Dim instance As FormViewDesigner

C#

public class FormViewDesigner : DataBoundControlDesigner

C++

public ref class FormViewDesigner : public
 DataBoundControlDesigner

J#

public class FormViewDesigner extends DataBoundControlDesigner

JScript

public class FormViewDesigner extends
 DataBoundControlDesigner

解説

ビジュアルなデザイナでソース ビューからデザイン ビューに切り替えると、FormView コントロールを記述するマークアップのソース コードが解析され、コントロールのデザイン時バージョンがデザイン サーフェイスに作成されます。元のソース ビューに切り替えると、デザイン時コントロールがマークアップのソース コードに永続化され、Web ページのマークアップに反映されます。

FormViewDesigner クラスのプロパティは、次の機能を提供します。

• ActionLists プロパティは、DesignerActionListCollection オブジェクトを返します。一般にこのオブジェクトには、デザイナの継承ツリーの各レベルについて、DesignerActionList クラスから派生したオブジェクトが格納されます。

• AutoFormats プロパティは、[オートフォーマット] ダイアログ ボックスで表示するための書式指定スキームのコレクションを返します。

• TemplateGroups プロパティは、関連付けられた FormView のテンプレートに対して、テンプレート グループのコレクションを返します。

• UsePreviewControl プロパティは、常に true を返します。デザイナは、関連付けられた FormView の一時的なコピーを作成して、デザイン時のマークアップを生成します。

FormViewDesigner クラスのメソッドは、次の機能を提供します。

• GetDesignTimeHtml メソッドは、デザイン時に、関連付けられた FormView のレンダリングに使用するマークアップを返します。

• Initialize メソッドは、関連付けられた FormView をデザイナで表示、編集、デザインできるように準備します。

• OnSchemaRefreshed メソッドは、関連付けられた FormView のデータ ソースのスキーマが変更されたときに呼び出されます。

使用例

FormViewDesigner クラスを拡張し、FormView コントロールから派生したコントロールの外観をデザイン時に変更するコード例を次に示します。

この例では、MyFormView コントロールを FormView コントロールから派生させています。MyFormView は、単に FormView のコピーです。また、この例では、FormViewDesigner から MyFormViewDesigner クラスを派生させ、MyFormViewDesigner の DesignerAttribute オブジェクトを MyFormView コントロールに配置しています。

MyFormViewDesigner は、次の項目をオーバーライドします。

• SampleRowCount プロパティ。MyFormView のデザイン時ビューのページ行に 4 つのページ リンクが含まれていることを指定します。

• GetDesignTimeHtml メソッド。Caption プロパティが指定されている場合は、デザイン時の MyFormView グリッドの新しい先頭行としてこのプロパティを挿入します。MyFormView の BorderStyle プロパティの値が NotSet または None の場合、GetDesignTimeHtml は、コントロールの周囲に青い点線の境界線を描画して、コントロールの範囲をわかりやすくします。

Visual Basic

Imports System
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 ' MyFormView

    ' 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 ' MyFormViewDesigner
End Namespace ' Examples.VB.WebControls.Design

C#

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

継承階層

System.Object
   System.ComponentModel.Design.ComponentDesigner
     System.Web.UI.Design.HtmlControlDesigner
       System.Web.UI.Design.ControlDesigner
         System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner
           System.Web.UI.Design.WebControls.DataBoundControlDesigner
            System.Web.UI.Design.WebControls.FormViewDesigner

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FormViewDesigner メンバ
System.Web.UI.Design.WebControls 名前空間
FormView
DataBoundControlDesigner クラス
その他の技術情報
ASP.NET コントロール デザイナの概要
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成