HyperLinkDesigner.GetDesignTimeHtml Metode

Definisi

Ruang nama:

System.Web.UI.Design.WebControls

Rakitan:

System.Design.dll

Mendapatkan markup yang digunakan untuk merender kontrol terkait pada waktu desain.

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

public override string GetDesignTimeHtml();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Mengembalikan

String

String yang berisi markup yang digunakan untuk merender kontrol hyperlink terkait pada waktu desain.

Contoh

Contoh kode berikut menunjukkan cara mendapatkan CustomHyperLinkDesigner kelas dari HyperLinkDesigner kelas . Ini mengambil alih GetDesignTimeHtml metode untuk menyediakan nilai default untuk Text properti jika nilai asli untuk Text adalah string kosong (""). Ini memastikan bahwa kontrol terkait akan terlihat pada waktu desain.

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk HyperLinkDesigner kelas .

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

Keterangan

Metode ini GetDesignTimeHtml menghasilkan markup waktu desain untuk kontrol terkait HyperLink . Metode ini terlebih dahulu menyimpan salinan lokal properti Text, , NavigateUrldan ImageUrl , serta Controls koleksi anak. Ini menyediakan nilai default untuk properti ini jika nilai aslinya adalah null atau kosong. Metode ini GetDesignTimeHtml kemudian memanggil GetDesignTimeHtml metode dasar untuk menghasilkan markup dan memulihkan properti dan pengumpulan kontrol anak ke nilai aslinya, jika perlu.

Lihat juga

• HyperLink
• GetDesignTimeHtml()
• ControlDesigner