ControlDesigner.GetEmptyDesignTimeHtml Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.Design

Ensamblado:: System.Design.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Recupera el formato HTML para presentar un control de servidor web en tiempo de diseño que no tendrá ninguna representación visual en tiempo de ejecución.

protected:
 virtual System::String ^ GetEmptyDesignTimeHtml();

protected virtual string GetEmptyDesignTimeHtml();

abstract member GetEmptyDesignTimeHtml : unit -> string
override this.GetEmptyDesignTimeHtml : unit -> string

Protected Overridable Function GetEmptyDesignTimeHtml () As String

Devoluciones

String

Marcado HTML que se usa para presentar un control en tiempo de diseño que, de lo contrario, no tendría ninguna representación visual. El valor predeterminado es un rectángulo que contiene el tipo y el identificador del componente.

Ejemplos

En el ejemplo de código siguiente se muestra cómo invalidar el GetDesignTimeHtml método en un diseñador de controles personalizado. Si la Text propiedad del control asociado está vacía, el GetDesignTimeHtml método llama al GetEmptyDesignTimeHtml método . De lo contrario, el GetDesignTimeHtml método crea y representa un Hyperlink control .

public override string GetDesignTimeHtml()
{
    if (simpleControl.Text.Length > 0)
    {
        string spec = "<a href='{0}.aspx'>{0}</a>";
        return String.Format(spec, simpleControl.Text);
    }
    else
    {
        return GetEmptyDesignTimeHtml();
    }
}

Public Overrides Function GetDesignTimeHtml() As String
   ' Component is the instance of the component or control that
   ' this designer object is associated with. This property is 
   ' inherited from System.ComponentModel.ComponentDesigner.
   simpleControl = CType(Component, Simple)
   
   If simpleControl.Text.Length > 0 Then
      Dim sw As New StringWriter()
      Dim tw As New HtmlTextWriter(sw)
      
      Dim placeholderLink As New HyperLink()
      
      ' Put simpleControl.Text into the link's Text.
      placeholderLink.Text = simpleControl.Text
      placeholderLink.NavigateUrl = simpleControl.Text
      placeholderLink.RenderControl(tw)
      
      Return sw.ToString()
   Else
      Return GetEmptyDesignTimeHtml()
   End If
End Function

Comentarios

El comportamiento predeterminado del GetEmptyDesignTimeHtml método es devolver una cadena que contiene el nombre del componente. Se GetEmptyDesignTimeHtml debe llamar al método en la implementación del GetDesignTimeHtml método cuando no hay marcado HTML en tiempo de diseño.

Se aplica a

Produto	Versións
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Compartir por