Udostępnij za pośrednictwem

DataListDesigner.GetDesignTimeHtml Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.Design.WebControls
Zestaw:
System.Design.dll

Pobiera kod HTML używany do reprezentowania kontrolki DataList w czasie projektowania.

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

Zwraca

String

Kod HTML, który jest używany do reprezentowania kontrolki DataList w czasie projektowania.

Przykłady

Poniższy przykład kodu pokazuje, jak zastąpić metodę GetDesignTimeHtml . Zmienia wygląd kontrolki na powierzchni projektowej, jeśli właściwość kontrolki WebControl.Enabled to true.

Kod używa Try...Catch...Finally składni do wykonania następujących czynności:

  • Sekcja Try zmienia wartości właściwości kontrolki.

  • Sekcja Catch przechwytuje wszelkie wyjątki i wysyła je do GetErrorDesignTimeHtml metody.

  • Sekcja Finally ustawia właściwości na ich oryginalne wartości.

Ten przykład kodu jest częścią większego przykładu podanego DataListDesigner dla klasy.

public override string GetDesignTimeHtml()
{
    string designTimeHtml = String.Empty;

    simpleGView = (SimpleGridView)Component;

    // Check the control's BorderStyle property to  
    // conditionally render design-time HTML.
    if (simpleGView.BorderStyle == BorderStyle.NotSet)
    {
        // Save the current property settings in variables.
        int oldCellPadding = simpleGView.CellPadding;
        Unit oldBorderWidth = simpleGView.BorderWidth;
        Color oldBorderColor = simpleGView.BorderColor;

        // Set properties and generate the design-time HTML.
        try
        {
            simpleGView.Caption = "SimpleGridView";
            simpleGView.CellPadding = 1;
            simpleGView.BorderWidth = Unit.Pixel(3);
            simpleGView.BorderColor = Color.Red;

            designTimeHtml = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            // Get HTML from the GetErrorDesignTimeHtml 
            // method if an exception occurs.
            designTimeHtml = GetErrorDesignTimeHtml(ex);

            // Return the properties to their original values.
        }
        finally
        {
            simpleGView.CellPadding = oldCellPadding;
            simpleGView.BorderWidth = oldBorderWidth;
            simpleGView.BorderColor = oldBorderColor;
        }
    }
    else
    {
        designTimeHtml = base.GetDesignTimeHtml();
    }

    return designTimeHtml;
}

protected override string
    GetErrorDesignTimeHtml(System.Exception exc)
{
    return CreatePlaceHolderDesignTimeHtml(
        "ASPNET.Examples: An error occurred while rendering the GridView.");
}

Public Overrides Function GetDesignTimeHtml() As String
    Dim designTimeHtml As String = String.Empty

    simpleGView = CType(Component, SimpleGridView)

    ' Check the control's BorderStyle property to  
    ' conditionally render design-time HTML.
    If (simpleGView.BorderStyle = BorderStyle.NotSet) Then
        ' Save the current property settings in variables.
        Dim oldCellPadding As Integer = simpleGView.CellPadding
        Dim oldBorderWidth As Unit = simpleGView.BorderWidth
        Dim oldBorderColor As Color = simpleGView.BorderColor

        ' Set properties and generate the design-time HTML.
        Try
            simpleGView.Caption = "SimpleGridView"
            simpleGView.CellPadding = 1
            simpleGView.BorderWidth = Unit.Pixel(3)
            simpleGView.BorderColor = Color.Red

            designTimeHtml = MyBase.GetDesignTimeHtml()

        Catch ex As Exception
            ' Get HTML from the GetErrorDesignTimeHtml 
            ' method if an exception occurs.
            designTimeHtml = GetErrorDesignTimeHtml(ex)

            ' Return the properties to their original values.
        Finally
            simpleGView.CellPadding = oldCellPadding
            simpleGView.BorderWidth = oldBorderWidth
            simpleGView.BorderColor = oldBorderColor
        End Try

    Else
        designTimeHtml = MyBase.GetDesignTimeHtml()
    End If

    Return designTimeHtml
End Function

Protected Overrides Function _
    GetErrorDesignTimeHtml(ByVal exc As Exception) As String

    Return CreatePlaceHolderDesignTimeHtml( _
        "ASPNET.Examples: An error occurred while rendering the GridView.")

End Function

Dotyczy

Zobacz też