Freigeben über

DataListDesigner.GetDesignTimeHtml Methode

  • Referenz

Definition

Namespace:
System.Web.UI.Design.WebControls
Assembly:
System.Design.dll

Ruft den HTML-Code ab, der für die Darstellung des DataList-Steuerelements zur Entwurfszeit verwendet wird.

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

Gibt zurück

String

Der HTML-Code, der für die Darstellung des DataList-Steuerelements zur Entwurfszeit verwendet wird.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die GetDesignTimeHtml -Methode überschrieben wird. Dadurch wird die Darstellung des Steuerelements auf der Entwurfsoberfläche geändert, wenn die -Eigenschaft des Steuerelements WebControl.Enabled ist true.

Der Code verwendet Try...Catch...Finally Syntax für die folgenden Aktionen:

  • Im Try Abschnitt werden die Werte der Eigenschaften des Steuerelements geändert.

  • Der Catch Abschnitt fängt alle Ausnahmen ab und sendet sie an die GetErrorDesignTimeHtml -Methode.

  • Im Finally Abschnitt werden die Eigenschaften auf die ursprünglichen Werte festgelegt.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataListDesigner-Klasse bereitgestellt wird.

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

Gilt für:

Weitere Informationen