ControlDesigner.GetEmptyDesignTimeHtml Methode

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

Gibt zurück

Das HTML-Markup, das zum Darstellen eines Steuerelements zur Entwurfszeit verwendet wird, das andernfalls keine visuelle Darstellung hätte. Der Standard ist ein Rechteck, das den Typ und die ID der Komponente enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetDesignTimeHtml -Methode in einem benutzerdefinierten Steuerelement-Designer überschrieben wird. Wenn die Text Eigenschaft für das zugeordnete Steuerelement leer ist, ruft die Methode auf GetDesignTimeHtmlGetEmptyDesignTimeHtml . Andernfalls erstellt und rendert die GetDesignTimeHtml -Methode ein Hyperlink -Steuerelement.

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

Hinweise

Das Standardverhalten der GetEmptyDesignTimeHtml -Methode besteht darin, eine Zeichenfolge zurückzugeben, die den Namen der Komponente enthält. Die GetEmptyDesignTimeHtml -Methode sollte in der Implementierung der GetDesignTimeHtml -Methode aufgerufen werden, wenn kein HTML-Markup zur Entwurfszeit vorhanden ist.

Gilt für:

Weitere Informationen

• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml
• Übersicht über ASP.NET-Steuerelement-Designer