HyperLinkDesigner.GetDesignTimeHtml Méthode

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

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Retours

String

Chaîne qui contient le balisage utilisé pour rendre le contrôle hypertexte associé au moment du design.

Exemples

L’exemple de code suivant montre comment dériver la CustomHyperLinkDesigner classe de la HyperLinkDesigner classe. Elle remplace la GetDesignTimeHtml méthode pour fournir une valeur par défaut pour la Text propriété si la valeur d’origine est Text une chaîne vide («  »). Cela garantit que le contrôle associé sera visible au moment du design.

Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

La GetDesignTimeHtml méthode génère le balisage au moment du design pour le contrôle associé HyperLink . La méthode enregistre d’abord les copies locales des Textpropriétés NavigateUrl, ainsi ImageUrl que la Controls collection enfant. Il fournit des valeurs par défaut pour ces propriétés si les valeurs d’origine sont ou vides null . La GetDesignTimeHtml méthode appelle ensuite la GetDesignTimeHtml méthode de base pour générer le balisage et restaurer les propriétés et la collection de contrôles enfants sur leurs valeurs d’origine, si nécessaire.

S’applique à

Voir aussi

• HyperLink
• GetDesignTimeHtml()
• ControlDesigner