Condividi tramite

HyperLinkDesigner.GetDesignTimeHtml Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.Design.WebControls
Assembly:
System.Design.dll

Ottiene il markup usato per il rendering del controllo associato in fase di progettazione.

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

Restituisce

String

Stringa contenente il markup utilizzato per eseguire il rendering del controllo del collegamento ipertestuale associato in fase di progettazione.

Esempio

Nell'esempio di codice seguente viene illustrato come derivare la CustomHyperLinkDesigner classe dalla HyperLinkDesigner classe . Esegue l'override del GetDesignTimeHtml metodo per fornire un valore predefinito per la Text proprietà se il valore originale per Text è una stringa vuota (""). In questo modo si garantisce che il controllo associato sia visibile in fase di progettazione.

Questo esempio di codice fa parte di un esempio più ampio fornito per la HyperLinkDesigner classe .

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

Commenti

Il GetDesignTimeHtml metodo genera il markup in fase di progettazione per il controllo associato HyperLink . Il metodo salva prima copie locali delle Textproprietà , NavigateUrle ImageUrl , nonché della Controls raccolta figlio. Fornisce valori predefiniti per queste proprietà se i valori originali sono null o vuoti. Il GetDesignTimeHtml metodo chiama quindi il GetDesignTimeHtml metodo di base per generare il markup e ripristina le proprietà e la raccolta di controlli figlio ai valori originali, se necessario.

Si applica a

Vedi anche