Sdílet prostřednictvím

HyperLinkDesigner.GetDesignTimeHtml Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.Design.WebControls
Sestavení:
System.Design.dll

Získá revize, která se používá k vykreslení přidruženého ovládacího prvku v době návrhu.

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

Návraty

String

Řetězec obsahující kód použitý k vykreslení přidruženého ovládacího prvku hypertextového odkazu v době návrhu.

Příklady

Následující příklad kódu ukazuje, jak odvodit CustomHyperLinkDesigner třídu z HyperLinkDesigner třídy. Přepíše metodu GetDesignTimeHtml pro zadání výchozí hodnoty vlastnosti Text , pokud původní hodnota pro Text je prázdný řetězec (""). Tím zajistíte, že přidružený ovládací prvek bude viditelný v době návrhu.

Tento příklad kódu je součástí většího příkladu zadaného HyperLinkDesigner pro třídu.

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

Poznámky

Metoda GetDesignTimeHtml vygeneruje kód návrhu pro přidružený HyperLink ovládací prvek. Metoda nejprve uloží místní kopie Text, NavigateUrla vlastnosti, ImageUrl stejně jako podřízenou Controls kolekci. Poskytuje výchozí hodnoty pro tyto vlastnosti, pokud jsou null původní hodnoty nebo prázdné. Metoda GetDesignTimeHtml pak zavolá základní metodu GetDesignTimeHtml , aby vygenerovala revize a v případě potřeby obnoví vlastnosti a podřízenou kolekci ovládacích prvků do původních hodnot.

Platí pro

Viz také