다음을 통해 공유

DetailsViewDesigner.GetDesignTimeHtml 메서드

  • 참조

정의

네임스페이스:
System.Web.UI.Design.WebControls
어셈블리:
System.Design.dll

연결된 DetailsView 컨트롤을 디자인 타임에 렌더링하는 데 사용되는 태그를 가져옵니다.

오버로드

GetDesignTimeHtml()

디자인 타임에, 연결된 컨트롤을 렌더링하는 데 사용되는 태그를 가져옵니다.
GetDesignTimeHtml(DesignerRegionCollection)

디자인 타임에, 연결된 컨트롤을 렌더링하는 데 사용되는 태그를 가져와서 디자이너 영역의 컬렉션을 채웁니다.

GetDesignTimeHtml()

디자인 타임에, 연결된 컨트롤을 렌더링하는 데 사용되는 태그를 가져옵니다.

public:
 override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml ();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String

반환

String

디자인 타임에 DetailsView을(를) 렌더링하는 데 사용되는 태그가 포함된 String입니다.

예제

다음 코드 예제에서는 재정의 하는 방법을 보여 줍니다.는 GetDesignTimeHtml 에서 상속 된 클래스에서 메서드를 DetailsViewDesigner 클래스의 모양을 변경 하는 DetailsView 디자인 타임에 컨트롤입니다. 예제를 포함 하도록 표에 새 첫 번째 행을 추가 합니다 Caption 속성인 경우는 Caption 정의 됩니다. 경우는 BorderStyle 에서 파생 된 컨트롤의 속성 DetailsView 는 NotSet 또는 None 값을 GetDesignTimeHtml 해당 범위 보다 편리 하 게 컨트롤 주변의 파란색 파선된 테두리를 그립니다. 컨트롤의 런타임 모양을 변경 하지 않습니다.

// 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

' 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

설명

먼저를 GetDesignTimeHtml() 메서드 집합을 AutoGenerateRows 의 속성을 DetailsView 컨트롤을 true경우는 Fields 컬렉션이 비어. GetDesignTimeHtml 설정한 합니다 DataKeyNames 의 컬렉션을 GetDesignTimeHtml 빈 컨트롤 String 데이터 원본의 스키마를 가져올 수 없으면 배열. 새로 고치는 TypeDescriptor 적용할 개체를 PreFilterProperties 호출 될 메서드입니다. 다음 태그를 생성 하기 위한 기본 메서드를 호출 합니다.

상속자 참고

재정의 하는 경우는 GetDesignTimeHtml() 메서드를 결국 여러 재정의 수준을 통해 호출 하므로에 기본 메서드를 호출 하는 DetailsView 컨트롤이 나 태그를 생성 하는 컨트롤의 복사본입니다.

추가 정보

적용 대상

GetDesignTimeHtml(DesignerRegionCollection)

디자인 타임에, 연결된 컨트롤을 렌더링하는 데 사용되는 태그를 가져와서 디자이너 영역의 컬렉션을 채웁니다.

public:
 override System::String ^ GetDesignTimeHtml(System::Web::UI::Design::DesignerRegionCollection ^ regions);
public override string GetDesignTimeHtml (System.Web.UI.Design.DesignerRegionCollection regions);
override this.GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
Public Overrides Function GetDesignTimeHtml (regions As DesignerRegionCollection) As String

매개 변수

regions
DesignerRegionCollection

컨트롤의 디자인 타임 보기에서 선택 및 클릭할 수 있는 영역의 정의를 추가할 DesignerRegionCollection입니다.

반환

String

디자인 타임에 DetailsView을(를) 렌더링하는 데 사용되는 태그가 포함된 String입니다.

예제

다음 코드 예제에서는 재정의 하는 방법을 보여 줍니다.는 GetDesignTimeHtml 에서 상속 된 클래스에서 메서드를 DetailsViewDesigner 클래스의 모양을 변경 하는 DetailsView 디자인 타임에 컨트롤입니다. 예제를 포함 하도록 표에 새 첫 번째 행을 추가 합니다 Caption 속성인 경우는 Caption 정의 됩니다. 경우는 BorderStyle 에서 파생 된 컨트롤의 속성을 DetailsView 는 NotSet 또는 None 값은 GetDesignTimeHtml 해당 범위 보다 편리 하 게 컨트롤 주변의 파란색 파선된 테두리를 그립니다. 컨트롤의 런타임 모양을 변경 하지 않습니다.

// 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

' 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

설명

DetailsViewDesigner.GetDesignTimeHtml 메서드 호출을 DetailsViewDesigner.GetDesignTimeHtml 의 디자인 타임 렌더링에 대 한 태그를 생성 하는 메서드는 DetailsView 컨트롤. 합니다 DetailsViewDesigner.GetDesignTimeHtml 메서드 채웁니다 regions 사용 하 여를 DesignerRegion 디자인 타임 렌더링의 각 선택 또는 클릭 가능한 영역에 대 한 개체입니다.

에 대 한는 DetailsView, 각 행의 첫 번째 셀은 선택할 수 있는 행의 모든 셀을 클릭할 수 있습니다.

상속자 참고

재정의 하는 경우는 GetDesignTimeHtml(DesignerRegionCollection) 메서드를 기본 메서드를 호출 해야 합니다. 또는 GetDesignTimeHtml() 결국 여러 재정의 수준을 통해 호출에서 때문에 오버 로드는 DetailsView 컨트롤이 나 태그를 생성 하는 컨트롤의 복사본입니다.

추가 정보

적용 대상