Udostępnij za pośrednictwem

HyperLinkDesigner.GetDesignTimeHtml Metoda

  • Odwołanie

Definicja

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

Pobiera znaczniki używane do renderowania skojarzonej kontrolki 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

Ciąg zawierający znaczniki używane do renderowania skojarzonej kontrolki hiperlinków w czasie projektowania.

Przykłady

Poniższy przykład kodu pokazuje, jak uzyskać klasę CustomHyperLinkDesigner HyperLinkDesigner z klasy. GetDesignTimeHtml Zastępuje metodę , aby podać wartość domyślną dla właściwości, jeśli oryginalna wartość elementu Text Text to pusty ciąg (""). Dzięki temu skojarzona kontrolka będzie widoczna w czasie projektowania.

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

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

Uwagi

Metoda GetDesignTimeHtml generuje znacznik czasu projektowania dla skojarzonej HyperLink kontrolki. Metoda najpierw zapisuje lokalne kopie Textwłaściwości , NavigateUrli ImageUrl oraz kolekcji podrzędnej Controls . Udostępnia wartości domyślne dla tych właściwości, jeśli oryginalne wartości są null lub puste. Następnie GetDesignTimeHtml metoda wywołuje metodę podstawową GetDesignTimeHtml , aby wygenerować znaczniki i przywrócić właściwości i kolekcję kontrolek podrzędnych do oryginalnych wartości, w razie potrzeby.

Dotyczy

Zobacz też