ListControlDesigner.GetDesignTimeHtml 메서드

정의

네임스페이스:

System.Web.UI.Design.WebControls

어셈블리:

System.Design.dll

디자인 타임에 컨트롤을 나타내는 데 사용할 HTML을 가져옵니다.

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

반환

String

디자인 타임에 String에서 파생되는 컨트롤을 렌더링하는 데 사용되는 태그가 포함된 ListControl입니다.

예제

다음 코드 예제를 재정의 GetDesignTimeHtml 하는 디자인 화면에서 관련 된 컨트롤에 대 한 표시 되는 태그를 사용자 지정 하는 방법입니다. 속성이 BackColor 연결된 컨트롤에 대해 정의되지 않은 경우 로 설정 Gainsboro되고 컨트롤이 해당 배경색으로 표시됩니다. 이 작업이 완료되면 메서드의 기본 구현이 GetDesignTimeHtml 호출됩니다.

이 코드 예제는에 대해 제공 된 큰 예제의 일부는 ListControlDesigner 클래스입니다.

// Create the markup to display the control on the design surface. 
public override string GetDesignTimeHtml()
{
    string designTimeMarkup = null;

    // Create variables to access the control
    // item collection and back color.
    ListItemCollection items = simpleRadioButtonList.Items;
    Color oldBackColor = simpleRadioButtonList.BackColor;

    // Check the property values and render the markup
    // on the design surface accordingly.
    try
    {
        if (oldBackColor == Color.Empty)
            simpleRadioButtonList.BackColor = Color.Gainsboro;

        if (changedDataSource)
            items.Add("Updated to a new data source: " + 
                DataSource + ".");

        // Call the base method to generate the markup.
        designTimeMarkup = base.GetDesignTimeHtml();
    }
    catch (Exception ex)
    {
        // Catch any exceptions that occur.
        designTimeMarkup = GetErrorDesignTimeHtml(ex);
    }
    finally
    {
        // Set the properties back to their original state.
        simpleRadioButtonList.BackColor = oldBackColor;
        items.Clear();
    }

    return designTimeMarkup;
} // GetDesignTimeHtml

' Create the markup to display the control on the design surface.
Public Overrides Function GetDesignTimeHtml() As String

    Dim designTimeHtml As String = String.Empty

    ' Create variables to access the control's
    ' item collection and back color. 
    Dim items As ListItemCollection = simpleRadioButtonList.Items
    Dim oldBackColor As Color = simpleRadioButtonList.BackColor

    ' Check the property values and render the markup
    ' on the design surface accordingly.
    Try
        If (Color.op_Equality(oldBackColor, Color.Empty)) Then
            simpleRadioButtonList.BackColor = Color.Gainsboro
        End If

        If (changedDataSource) Then
            items.Add( _
                "Updated to a new data source: " & DataSource & ".")
        End If

        designTimeHtml = MyBase.GetDesignTimeHtml()

    Catch ex As Exception
        ' Catch any exceptions that occur.
        MyBase.GetErrorDesignTimeHtml(ex)

    Finally
        ' Set the properties back to their original state.
        simpleRadioButtonList.BackColor = oldBackColor
        items.Clear()
    End Try

    Return designTimeHtml
End Function ' GetDesignTimeHtml

설명

개체에서 ListControl 파생된 연결된 컨트롤이 데이터 바인딩 GetDesignTimeHtml 된 경우 메서드는 컬렉션을 지우 Items 고 컨트롤이 데이터 바인딩됨을 나타내는 메시지를 추가합니다 String . 연결된 컨트롤이 데이터 바인딩 Items 되지 않고 컬렉션이 비어 GetDesignTimeHtml 있는 경우 는 컨트롤이 바인딩되지 않음을 나타내는 메시지를 추가합니다 String . 그런 다음, 는 GetDesignTimeHtml 기본 메서드를 호출하여 태그를 생성합니다.

추가 정보

• Items
• ListItem
• ListControl
• GetDesignTimeHtml()