HyperLinkDesigner.GetDesignTimeHtml Methode

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

public override string GetDesignTimeHtml();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Retouren

Een tekenreeks met de opmaak die wordt gebruikt om het bijbehorende hyperlink besturingselement op het ontwerptijd weer te geven.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de CustomHyperLinkDesigner klasse kunt afleiden uit de HyperLinkDesigner klasse. De methode voor het GetDesignTimeHtml opgeven van een standaardwaarde voor de Text eigenschap wordt overschreven als de oorspronkelijke waarde Text een lege tekenreeks ("") is. Dit zorgt ervoor dat het bijbehorende besturingselement tijdens het ontwerp zichtbaar is.

Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de HyperLinkDesigner klasse.

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

Opmerkingen

De GetDesignTimeHtml methode genereert de ontwerptijdmarkeringen voor het bijbehorende HyperLink besturingselement. Met de methode worden eerst lokale kopieën van de Text, NavigateUrlen eigenschappen en ImageUrl de Controls onderliggende verzameling opgeslagen. Het biedt standaardwaarden voor deze eigenschappen als de oorspronkelijke waarden of leeg zijn null . De GetDesignTimeHtml methode roept vervolgens de GetDesignTimeHtml basismethode aan om de opmaak te genereren en de eigenschappen en de verzameling onderliggende besturingselementen, indien nodig, te herstellen naar de oorspronkelijke waarden.

Zie ook

• HyperLink
• GetDesignTimeHtml()
• ControlDesigner