DetailsViewDesigner 클래스

정의

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

상속

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

BaseDataBoundControlDesigner

DataBoundControlDesigner

DetailsViewDesigner

예제

다음 코드 예제를 확장 하는 방법을 보여 줍니다 합니다 DetailsViewDesigner 클래스에서 파생 되는 컨트롤의 모양을 변경 하는 DetailsView 디자인 타임에 컨트롤입니다.

이 예제에서는 파생 되는 MyDetailsView 에서 제어를 DetailsView입니다. 합니다 MyDetailsView 는 단순히 복사는 DetailsView 제어 합니다. 예제 에서도 파생 됩니다는 MyDetailsViewDesigner 에서 클래스 DetailsViewDesigner 배치를 DesignerAttribute 개체에 대 한 MyDetailsViewDesigner 에 MyDetailsView 컨트롤입니다.

The MyDetailsViewDesigner 재정의 SampleRowCount 지정 하는 속성의 디자인 타임 뷰의 페이저 행을는 MyDetailsView 5 페이지 링크를 포함 합니다. 재정의 PreFilterProperties 메서드를 합니다 NamingContainer 속성에 표시 합니다 속성 디자인 타임에 눈금. 재정의 GetDesignTimeHtml 포함 하는 방법의 Caption 속성을 새 첫 번째 행으로 지정 된 경우는 MyDetailsView 디자인 타임에 눈금. 경우는 BorderStyle 의 속성을 MyDetailsView 는 NotSet 또는 None 값을는 GetDesignTimeHtml 해당 범위 보다 편리 하 게 컨트롤 주변의 파란색 파선된 테두리를 그립니다.

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

설명

비주얼 디자이너에서 소스 뷰에서 디자인 뷰로 전환 하면 태그 소스 코드를 설명 하는 DetailsView 컨트롤을 구문 분석 되 고 디자인 화면에서 컨트롤의 디자인 타임 버전을 만들어집니다. 소스 뷰로 다시 전환 하면 디자인 타임 컨트롤 태그 소스 코드에 유지 되 고 웹 페이지에 대 한 태그를 편집 합니다.

속성을 DetailsViewDesigner 클래스에는 다음 기능을 제공 합니다.

• ActionLists 속성에서 반환을 DesignerActionListCollection 일반적으로에서 파생 된 개체를 포함 하는 개체는 DesignerActionList 디자이너의 상속 트리의 각 수준에 대 한 클래스입니다.

• AutoFormats 속성에 표시할 서식 지정 구성표 컬렉션을 반환 합니다 자동 서식 대화 상자.

• TemplateGroups 속성 필드에 대 한 연결 된 템플릿 그룹의 컬렉션을 반환 DetailsView 컨트롤과 최상위 DetailsView 템플릿.

• 합니다 UsePreviewControl 속성은 항상 반환 true, 디자이너에 연결 된 임시 복사본을 만들어는 DetailsView 컨트롤 디자인 타임 태그를 생성 합니다.

DetailsViewDesigner 클래스 메서드는 다음 기능을 제공 합니다.

• 합니다 DataBind 메서드는 연결 된 바인딩합니다 DetailsView 컨트롤을 디자인 타임 데이터 소스입니다.

• 합니다 GetDesignTimeHtml 연결 된 렌더링 하는 데 사용 되는 태그를 반환 하는 메서드 DetailsView 디자인 타임.

• 합니다 Initialize 메서드를 보고 편집 하 고 연결 된 디자인 디자이너 준비 DetailsView합니다.

• 합니다 OnClick 메서드는 연결 된 디자인 타임 뷰의 영역 DetailsView 를 클릭 합니다.

• 합니다 OnSchemaRefreshed 메서드를 호출한 경우 연결 된 데이터 소스의 스키마 DetailsView 변경 합니다.

• 합니다 PreFilterProperties 제거 또는 추가 메서드를 사용 하거나 연결 된 섀도 속성을 DetailsView입니다.

디자인 타임에 편집할 수 있는 지역에서 지원 되지 않습니다 합니다 DetailsView 제어 하므로 GetEditableDesignerRegionContent 및 SetEditableDesignerRegionContent 메서드 기능이 없습니다.

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

• DetailsView
• DataBoundControlDesigner
• ASP.NET 컨트롤 디자이너 소개
• 연습: 웹 서버 컨트롤에 대 한 기본 컨트롤 디자이너 만들기