ControlDesigner.GetErrorDesignTimeHtml-Methode

Artikel
08/20/2007

Ruft das HTML-Markup ab, das Informationen zur angegebenen Ausnahme bereitstellt.

Namespace: System.Web.UI.Design
Assembly: System.Design (in system.design.dll)

Syntax

'Declaration
Protected Overridable Function GetErrorDesignTimeHtml ( _
    e As Exception _
) As String
'Usage
Dim e As Exception
Dim returnValue As String

returnValue = Me.GetErrorDesignTimeHtml(e)

protected virtual string GetErrorDesignTimeHtml (
    Exception e
)

protected:
virtual String^ GetErrorDesignTimeHtml (
    Exception^ e
)

protected String GetErrorDesignTimeHtml (
    Exception e
)

protected function GetErrorDesignTimeHtml (
    e : Exception
) : String

Parameter

e
Die aufgetretene Ausnahme.

Rückgabewert

Das Entwurfszeit-HTML-Markup für die angegebene Ausnahme.

Hinweise

Die GetErrorDesignTimeHtml-Methode wird i. d. R. aufgerufen, wenn eine Ausnahme in der GetDesignTimeHtml-Methode ausgelöst wird.

Hinweise für Erben Das typische Entwurfsmuster besteht darin, das HTML-Markup über das zugeordnete Steuerelement abzurufen und beim Auftreten eines Fehlers die GetErrorDesignTimeHtml-Methode aufzurufen. Wenn vom Steuerelement kein Markup zurückgegeben wird, wird die GetEmptyDesignTimeHtml-Methode aufgerufen. Wenn diese nicht überschrieben wurde, um spezielles Markup bereitzustellen, ruft sie die CreatePlaceHolderDesignTimeHtml-Methode auf, die Informationen zum Typ und der ID des Steuerelements enthält.

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie beim Auftreten eines Fehlers Entwurfszeit-HTML-Markup für das Steuerelement erstellt und die CreatePlaceHolderDesignTimeHtml-Methode aufgerufen werden kann.

' Generate the design-time markup for the control when an error occurs.
Protected Overrides Function GetErrorDesignTimeHtml( _
    ByVal ex As Exception) As String

    ' Write the error message text in red, bold.
    Dim errorRendering As String = _
        "<span style=""font-weight:bold; color:Red; "">" & _
        ex.Message & "</span>"

    Return CreatePlaceHolderDesignTimeHtml(errorRendering)

End Function ' GetErrorDesignTimeHtml

// Generate the design-time markup for the control when an error occurs.
protected override string GetErrorDesignTimeHtml(Exception e) 
{
    // Write the error message text in red, bold.
    string errorRendering =
        "<span style=\"font-weight:bold; color:Red; \">" +
        e.Message + "</span>";

    return CreatePlaceHolderDesignTimeHtml(errorRendering);
} // GetErrorDesignTimeHtml

.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
GetDesignTimeHtml
CreateErrorDesignTimeHtml

Weitere Ressourcen

Entwurfszeitunterstützung für Web Forms

Freigeben über