HttpException Klasse

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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.

Beschreibt eine Ausnahme, die während der Verarbeitung von HTTP-Anforderungen aufgetreten ist.

public ref class HttpException : System::Runtime::InteropServices::ExternalException

public class HttpException : System.Runtime.InteropServices.ExternalException

[System.Serializable]
public class HttpException : System.Runtime.InteropServices.ExternalException

type HttpException = class
    inherit ExternalException

[<System.Serializable>]
type HttpException = class
    inherit ExternalException

Public Class HttpException
Inherits ExternalException

Vererbung: Object

Exception

SystemException

ExternalException
HttpException

Abgeleitet: System.Web.HttpCompileException

System.Web.HttpParseException

System.Web.HttpRequestValidationException

System.Web.HttpUnhandledException

Attribute: SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der HttpException Klasse zum Auslösen benutzerdefinierter Ausnahmen veranschaulicht. Die Button_Click Methode bestimmt, auf welche Schaltfläche geklickt wurde, und ruft dann entweder die oder CheckBoolean die CheckNumber Methode auf. Wenn der vom Benutzer eingegebene Wert im Textfeld nicht dem erwarteten Typ entspricht, wird eine HttpException Ausnahme erstellt und mit einer angepassten Nachricht basierend auf dem Fehlertyp ausgelöst.

Important

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    void CheckNumber()
    {
        try
        {
            // Check whether the value is an integer.
            String convertInt = textbox1.Text;
            Convert.ToInt32(convertInt);
        }
        catch (Exception e)
        {
            // Throw an HttpException with customized message.
            throw new HttpException("not an integer");
        }
    }
    void CheckBoolean()
    {
        try
        {
            // Check whether the value is an boolean.
            String convertBool = textbox1.Text;
            Convert.ToBoolean(convertBool);
        }
        catch (Exception e)
        {
            // Throw an HttpException with customized message.
            throw new HttpException("not a boolean");
        }
    }

    void Button_Click(Object sender, EventArgs e)
    {
        try
        {
            // Check to see which button was clicked.
            Button b = (Button)sender;
            if (b.ID.StartsWith("button1"))
                CheckNumber();
            else if (b.ID.StartsWith("button2"))
                CheckBoolean();

            label1.Text = "You entered: " + textbox1.Text;
            label1.ForeColor = System.Drawing.Color.Black;
        }
        // Catch the HttpException.
        catch (HttpException exp)
        {
            label1.Text = "An HttpException was raised. "
               + "The value entered in the textbox is " + exp.Message.ToString();
            label1.ForeColor = System.Drawing.Color.Red;
        }
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpException Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <br />
        <b>Enter a value in the text box.</b>
        <br />
        <asp:TextBox ID="textbox1" 
                     Runat="server">
        </asp:TextBox>
        <br />
        <asp:Button ID="button1"
                    Text="Check for integer."  
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Button ID="button2"
                    Text="Check for boolean." 
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Label ID="label1" 
                   Runat="server">
        </asp:Label>    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  Sub CheckNumber()
    
    Try

      ' Check whether the value is an integer.
      Dim convertInt As String = textbox1.Text
      Convert.ToInt32(convertInt)

    Catch e As Exception

      ' Throw an HttpException with customized message.
      Throw New HttpException("not an integer")

    End Try

  End Sub

  Sub CheckBoolean()
    
    Try

      ' Check whether the value is an boolean.
      Dim convertBool As String = textbox1.Text
      Convert.ToBoolean(convertBool)

    Catch e As Exception

      ' Throw an HttpException with customized message.
      Throw New HttpException("not a boolean")

    End Try

  End Sub

  Sub Button_Click(ByVal sender As [Object], ByVal e As EventArgs)
    
    Try

      ' Check to see which button was clicked.
      Dim b As Button = CType(sender, Button)
      If b.ID.StartsWith("button1") Then
        CheckNumber()
      ElseIf b.ID.StartsWith("button2") Then
        CheckBoolean()
      End If

      label1.Text = "You entered: " + textbox1.Text
      label1.ForeColor = System.Drawing.Color.Black

      ' Catch the HttpException.
    Catch exp As HttpException

      label1.Text = "An HttpException was raised. " + "The value entered in the textbox is " + exp.Message.ToString()
      label1.ForeColor = System.Drawing.Color.Red

    End Try

  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpException Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <br />
        <b>Enter a value in the text box.</b>
        <br />
        <asp:TextBox ID="textbox1" 
                     Runat="server">
        </asp:TextBox>
        <br />
        <asp:Button ID="button1"
                    Text="Check for integer."  
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Button ID="button2"
                    Text="Check for boolean." 
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Label ID="label1" 
                   Runat="server">
        </asp:Label>    
    </div>
    </form>
</body>
</html>

Hinweise

Die HttpException-Klasse ist eine HTTP-spezifische Ausnahmeklasse, mit der ASP.NET Ausnahmeinformationen generieren können. Weitere Informationen zum Auslösen und Behandeln von Ausnahmen finden Sie unter Ausnahmen.

Konstruktoren

Name	Beschreibung
HttpException()	Initialisiert eine neue Instanz der HttpException Klasse und erstellt ein leeres HttpException Objekt.
HttpException(Int32, String, Exception)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe eines HTTP-Antwortstatuscodes, einer Fehlermeldung und der InnerException Eigenschaft.
HttpException(Int32, String, Int32)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe eines HTTP-Antwortstatuscodes, einer Fehlermeldung und eines Ausnahmecodes.
HttpException(Int32, String)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe eines HTTP-Antwortstatuscodes und einer Fehlermeldung.
HttpException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der HttpException Klasse mit serialisierten Daten.
HttpException(String, Exception)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe einer Fehlermeldung und der InnerException Eigenschaft.
HttpException(String, Int32)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe einer Fehlermeldung und eines Ausnahmecodes.
HttpException(String)	Initialisiert eine neue Instanz der HttpException Klasse mithilfe einer bereitgestellten Fehlermeldung.

Eigenschaften

Name	Beschreibung
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
ErrorCode	Ruft den `HRESULT` Fehler ab. (Geerbt von ExternalException)
HelpLink	Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception)
HResult	Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception)
InnerException	Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception)
Source	Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)
WebEventCode	Ruft die Ereigniscodes ab, die der HTTP-Ausnahme zugeordnet sind.

Methoden

Name	Beschreibung
CreateFromLastError(String)	Erstellt eine neue HttpException Ausnahme basierend auf dem Fehlercode, der von der methode Windows API `GetLastError()` zurückgegeben wird.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetHtmlErrorMessage()	Ruft die HTML-Fehlermeldung ab, die an den Client zurückgegeben werden soll.
GetHttpCode()	Ruft den HTTP-Antwortstatuscode ab, der an den Client zurückgegeben werden soll.
GetObjectData(SerializationInfo, StreamingContext)	Ruft Informationen über die Ausnahme ab und fügt sie dem SerializationInfo Objekt hinzu.
GetObjectData(SerializationInfo, StreamingContext)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden die SerializationInfo Informationen zur Ausnahme festgelegt. (Geerbt von Exception)
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält. (Geerbt von ExternalException)

Ereignisse

Name	Beschreibung
SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?