Share via

HyperLinkDesigner.GetDesignTimeHtml Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.Design.WebControls
Ensamblado:
System.Design.dll

Obtiene el marcado que se usa para representar el control asociado en tiempo de diseño.

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

Devoluciones

String

Cadena que contiene el marcado que se utiliza para representar el control de hipervínculo asociado en tiempo de diseño.

Ejemplos

En el ejemplo de código siguiente se muestra cómo derivar la CustomHyperLinkDesigner clase de la HyperLinkDesigner clase . Reemplaza el GetDesignTimeHtml método para proporcionar un valor predeterminado para la Text propiedad si el valor original de Text es una cadena vacía (""). Esto garantiza que el control asociado estará visible en tiempo de diseño.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la HyperLinkDesigner clase .

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

Comentarios

El GetDesignTimeHtml método genera el marcado en tiempo de diseño para el control asociado HyperLink . El método guarda primero copias locales de las Textpropiedades , NavigateUrly ImageUrl , así como la Controls colección secundaria. Proporciona valores predeterminados para estas propiedades si los valores originales son null o están en blanco. A continuación, el GetDesignTimeHtml método llama al GetDesignTimeHtml método base para generar el marcado y restaura las propiedades y la colección de controles secundarios a sus valores originales, si es necesario.

Se aplica a

Consulte también