Teilen über

HyperLinkDesigner.GetDesignTimeHtml Methode

  • Referenz

Definition

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

Ruft das Markup ab, das zum Rendern des zugeordneten 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

Eine Zeichenfolge, die das Markup enthält, mit dem der zugeordnete Link zur Entwurfszeit gerendert wird.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die CustomHyperLinkDesigner Klasse aus der HyperLinkDesigner Klasse abgeleitet wird. Die Methode überschreibt den Standardwert für die GetDesignTimeHtml Text Eigenschaft, wenn der ursprüngliche Wert Text für eine leere Zeichenfolge ("") angegeben wird. Dadurch wird sichergestellt, dass das zugeordnete Steuerelement zur Entwurfszeit sichtbar ist.

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

// Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
public class CustomHyperLinkDesigner : HyperLinkDesigner
{
    // Override the GetDesignTimeHtml to set the CustomHyperLink Text 
    // property so that it displays at design time.
    public override string GetDesignTimeHtml()
    {
        CustomHyperLink hype = (CustomHyperLink)Component;
        string designTimeMarkup = null;

        // Save the original Text and note if it is empty.
        string text = hype.Text;
        bool noText = (text.Trim().Length == 0);

        try
        {
            // If the Text is empty, supply a default value.
            if (noText)
                hype.Text = "Click here.";

            // Call the base method to generate the markup.
            designTimeMarkup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            // If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // Restore the original value of the Text, if necessary.
            if (noText)
                hype.Text = text;
        }

        // If the markup is empty, generate the markup for a placeholder.
        if(designTimeMarkup == null || designTimeMarkup.Length == 0)
            designTimeMarkup = GetEmptyDesignTimeHtml();

        return designTimeMarkup;
    } // GetDesignTimeHtml
} // CustomHyperLinkDesigner

' Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
Public Class CustomHyperLinkDesigner
    Inherits HyperLinkDesigner

    ' Override the GetDesignTimeHtml to set the CustomHyperLink Text
    ' property so that it displays at design time.
    Public Overrides Function GetDesignTimeHtml() As String

        Dim hype As CustomHyperLink = CType(Component, CustomHyperLink)
        Dim designTimeMarkup As String = Nothing

        ' Save the original Text and note if it is empty.
        Dim text As String = hype.Text
        Dim noText As Boolean = (text.Trim().Length = 0)

        Try
            ' If the Text is empty, supply a default value.
            If noText Then
                hype.Text = "Click here."
            End If

            ' Call the base method to generate the markup.
            designTimeMarkup = MyBase.GetDesignTimeHtml()

        Catch ex As Exception
            ' If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex)

        Finally
            ' Restore the original value of the Text, if necessary.
            If noText Then
                hype.Text = text
            End If
        End Try

        ' If the markup is empty, generate the markup for a placeholder.
        If ((designTimeMarkup = Nothing) Or _
            (designTimeMarkup.Length = 0)) Then
            designTimeMarkup = GetEmptyDesignTimeHtml()
        End If

        Return designTimeMarkup

    End Function ' GetDesignTimeHtml
End Class

Hinweise

Die GetDesignTimeHtml Methode generiert das Entwurfszeit-Markup für das zugeordnete HyperLink Steuerelement. Die Methode speichert zuerst lokale Kopien der TextNavigateUrl, und ImageUrl Eigenschaften sowie die Controls untergeordnete Auflistung. Es stellt Standardwerte für diese Eigenschaften bereit, wenn die ursprünglichen Werte oder leer sind null . Die GetDesignTimeHtml Methode ruft dann die GetDesignTimeHtml Basismethode auf, um das Markup zu generieren und die Eigenschaften und untergeordnete Steuerelementsammlung bei Bedarf auf ihre ursprünglichen Werte zurückzusetzen.

Gilt für

Siehe auch