ControlDesigner.GetEmptyDesignTimeHtml-Methode
Ruft das HTML-Markup ab, das ein Webserver-Steuerelement zur Entwurfszeit darstellt, für das zur Laufzeit keine visuelle Darstellung ausgegeben wird.
Namespace: System.Web.UI.Design
Assembly: System.Design (in system.design.dll)
Syntax
'Declaration
Protected Overridable Function GetEmptyDesignTimeHtml As String
'Usage
Dim returnValue As String
returnValue = Me.GetEmptyDesignTimeHtml
protected virtual string GetEmptyDesignTimeHtml ()
protected:
virtual String^ GetEmptyDesignTimeHtml ()
protected String GetEmptyDesignTimeHtml ()
protected function GetEmptyDesignTimeHtml () : String
Rückgabewert
Das HTML-Markup, mit dem ein Steuerelement zur Entwurfszeit dargestellt wird, für das sonst keine visuelle Darstellung vorhanden ist. In der Standardeinstellung wird ein Rechteck verwendet, das den Typ und die ID der Komponente enthält.
Hinweise
Das Standardverhalten der GetEmptyDesignTimeHtml-Methode besteht in der Rückgabe einer Zeichenfolge mit dem Namen der Komponente. Wenn kein Entwurfszeit-HTML-Markup vorhanden ist, muss in der Implementierung der GetDesignTimeHtml-Methode die GetEmptyDesignTimeHtml-Methode aufgerufen werden.
Beispiel
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 GetDesignTimeHtml-Methode die GetEmptyDesignTimeHtml-Methode auf. Andernfalls erstellt die GetDesignTimeHtml-Methode ein Hyperlink-Steuerelement und stellt dieses dar.
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.href = simpleControl.Text
placeholderLink.RenderControl(tw)
Return sw.ToString()
Else
Return GetEmptyDesignTimeHtml()
End If
End Function
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();
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ControlDesigner-Klasse
ControlDesigner-Member
System.Web.UI.Design-Namespace
GetErrorDesignTimeHtml
GetDesignTimeHtml