ControlDesigner.GetEmptyDesignTimeHtml Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das HTML-Markup zum Darstellen eines Webserver-Steuerelements zur Entwurfszeit ab, das zur Laufzeit keine visuelle Darstellung hat.
protected:
virtual System::String ^ GetEmptyDesignTimeHtml();protected virtual string GetEmptyDesignTimeHtml ();abstract member GetEmptyDesignTimeHtml : unit -> string
override this.GetEmptyDesignTimeHtml : unit -> stringProtected Overridable Function GetEmptyDesignTimeHtml () As StringGibt 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 die GetDesignTimeHtml -Methode ein Steuerelement und rendert es Hyperlink .
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.
