HttpException HttpException HttpException HttpException Class

Definition

Beschreibt eine Ausnahme, die während der Verarbeitung der HTTP-Anforderungen aufgetreten ist.Describes an exception that occurred during the processing of HTTP requests.

public ref class HttpException : System::Runtime::InteropServices::ExternalException
[System.Serializable]
public class HttpException : System.Runtime.InteropServices.ExternalException
type HttpException = class
    inherit ExternalException
Public Class HttpException
Inherits ExternalException
Vererbung
Abgeleitet
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mit HttpException der-Klasse angepasste Ausnahmen ausgelöst werden.The following code example demonstrates how to use the HttpException class to raise customized exceptions. Die Button_Click Methode bestimmt, auf welche Schaltfläche geklickt wurde, und ruft CheckNumber dann CheckBoolean entweder die-oder die-Methode auf.The Button_Click method determines which button was clicked, and then calls either the CheckNumber or CheckBoolean method. Wenn der vom Benutzer eingegebene Wert im Textfeld nicht dem erwarteten Typ entspricht, wird eine HttpException Ausnahme erstellt und mit einer benutzerdefinierten Meldung basierend auf dem Fehlertyp ausgelöst.If the user-entered value in the text box does not correspond to the expected type, an HttpException exception is created and thrown with a customized message based on the error type.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see 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

Bei HttpException der-Klasse handelt es sich um eine HTTP-spezifische Ausnahme Klasse, die ASP.NET das Generieren von Ausnahme Informationen ermöglicht.The HttpException class is an HTTP-specific exception class that enables ASP.NET to generate exception information. Weitere Informationen zum Auslösen und behandeln von Ausnahmen finden Sie unter Ausnahmen.For more information about throwing and handling exceptions, see Exceptions.

Konstruktoren

HttpException() HttpException() HttpException() HttpException()

Initialisiert eine neue Instanz der HttpException-Klasse und erstellt ein leeres HttpException-Objekt.Initializes a new instance of the HttpException class and creates an empty HttpException object.

HttpException(Int32, String) HttpException(Int32, String) HttpException(Int32, String) HttpException(Int32, String)

Initialisiert mit dem HTTP-Antwortstatuscode und einer Fehlermeldung eine neue Instanz der HttpException-Klasse.Initializes a new instance of the HttpException class using an HTTP response status code and an error message.

HttpException(Int32, String, Exception) HttpException(Int32, String, Exception) HttpException(Int32, String, Exception) HttpException(Int32, String, Exception)

Initialisiert mit dem HTTP-Antwortstatuscode, einer Fehlermeldung und der HttpException-Eigenschaft eine neue Instanz der InnerException-Klasse.Initializes a new instance of the HttpException class using an HTTP response status code, an error message, and the InnerException property.

HttpException(Int32, String, Int32) HttpException(Int32, String, Int32) HttpException(Int32, String, Int32) HttpException(Int32, String, Int32)

Initialisiert mit dem HTTP-Antwortstatuscode, einer Fehlermeldung und einem Ausnahmecode eine neue Instanz der HttpException-Klasse.Initializes a new instance of the HttpException class using an HTTP response status code, an error message, and an exception code.

HttpException(SerializationInfo, StreamingContext) HttpException(SerializationInfo, StreamingContext) HttpException(SerializationInfo, StreamingContext) HttpException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der HttpException-Klasse mit serialisierten Daten.Initializes a new instance of the HttpException class with serialized data.

HttpException(String) HttpException(String) HttpException(String) HttpException(String)

Initialisiert eine neue Instanz der HttpException-Klasse mit der angegebenen Fehlermeldung.Initializes a new instance of the HttpException class using a supplied error message.

HttpException(String, Exception) HttpException(String, Exception) HttpException(String, Exception) HttpException(String, Exception)

Initialisiert mit einer Fehlermeldung und der HttpException-Eigenschaft eine neue Instanz der InnerException-Klasse.Initializes a new instance of the HttpException class using an error message and the InnerException property.

HttpException(String, Int32) HttpException(String, Int32) HttpException(String, Int32) HttpException(String, Int32)

Initialisiert mithilfe einer Fehlermeldung und einem Ausnahmecode eine neue Instanz der HttpException-Klasse.Initializes a new instance of the HttpException class using an error message and an exception code.

Eigenschaften

Data Data Data Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
ErrorCode ErrorCode ErrorCode ErrorCode

Ruft das HRESULT des Fehlers ab.Gets the HRESULT of the error.

(Inherited from ExternalException)
HelpLink HelpLink HelpLink HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)
WebEventCode WebEventCode WebEventCode WebEventCode

Ruft die Ereigniscodes ab, die der HTTP-Ausnahme zugeordnet sind.Gets the event codes that are associated with the HTTP exception.

Methoden

CreateFromLastError(String) CreateFromLastError(String) CreateFromLastError(String) CreateFromLastError(String)

Erstellt eine neue HttpException-Ausnahme auf Grundlage des Fehlercodes, der von der Windows-API-GetLastError()-Methode zurückgegeben wird.Creates a new HttpException exception based on the error code that is returned from the Windows API GetLastError() method.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetHtmlErrorMessage() GetHtmlErrorMessage() GetHtmlErrorMessage() GetHtmlErrorMessage()

Ruft die HTML-Fehlermeldung ab, die an den Client zurückgegeben wird.Gets the HTML error message to return to the client.

GetHttpCode() GetHttpCode() GetHttpCode() GetHttpCode()

Ruft den HTTP-Antwortstatuscode ab, der an den Client zurückgegeben wird.Gets the HTTP response status code to return to the client.

GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Ruft Informationen zu der Ausnahme ab und fügt sie dem SerializationInfo-Objekt hinzu.Gets information about the exception and adds it to the SerializationInfo object.

GetType() GetType() GetType() GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält.Returns a string that contains the HRESULT of the error.

(Inherited from ExternalException)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Gilt für:

Siehe auch