HttpException Osztály

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A HTTP-kérések feldolgozása során történt kivételt ismerteti.

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

Öröklődés: Object

Exception

SystemException

ExternalException
HttpException

Származtatott: System.Web.HttpCompileException

System.Web.HttpParseException

System.Web.HttpRequestValidationException

System.Web.HttpUnhandledException

Attribútumok: SerializableAttribute

Példák

Az alábbi példakód bemutatja, hogyan használhatja az HttpException osztályt a testreszabott kivételek létrehozásához. A Button_Click metódus meghatározza, hogy melyik gombra kattintott, majd meghívja a vagy CheckNumber a metódustCheckBoolean. Ha a szövegmezőben a felhasználó által megadott érték nem felel meg a várt típusnak, a rendszer kivételt HttpException hoz létre, és a hibatípus alapján testre szabott üzenet jelenik meg.

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

<%@ 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>

Megjegyzések

A HttpException osztály egy HTTP-specifikus kivételosztály, amely lehetővé teszi, hogy ASP.NET kivételadatokat hozzon létre. A kivételek kivetésével és kezelésével kapcsolatos további információkért lásd a Kivételek című témakört.

Konstruktorok

Name	Description
HttpException()	Inicializálja az osztály új példányát HttpException , és létrehoz egy üres HttpException objektumot.
HttpException(Int32, String, Exception)	Inicializálja az HttpException osztály új példányát EGY HTTP-válasz állapotkód, egy hibaüzenet és a InnerException tulajdonság használatával.
HttpException(Int32, String, Int32)	Inicializálja az HttpException osztály új példányát EGY HTTP-válasz állapotkód, egy hibaüzenet és egy kivételkód használatával.
HttpException(Int32, String)	Inicializálja az HttpException osztály új példányát EGY HTTP-válasz állapotkód és egy hibaüzenet használatával.
HttpException(SerializationInfo, StreamingContext)	Inicializálja az HttpException osztály új példányát szerializált adatokkal.
HttpException(String, Exception)	Inicializálja az HttpException osztály új példányát egy hibaüzenet és egy InnerException tulajdonság használatával.
HttpException(String, Int32)	Inicializálja az HttpException osztály új példányát egy hibaüzenet és egy kivételkód használatával.
HttpException(String)	Inicializálja az HttpException osztály új példányát egy megadott hibaüzenet használatával.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
ErrorCode	Lekéri a `HRESULT` hibát. (Öröklődés forrása ExternalException)
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)
WebEventCode	Lekéri a HTTP-kivételhez társított eseménykódokat.

Metódusok

Name	Description
CreateFromLastError(String)	Létrehoz egy új HttpException kivételt a Windows API `GetLastError()` metódusból visszaadott hibakód alapján.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetHtmlErrorMessage()	Lekéri a HTML-hibaüzenetet, hogy visszatérjen az ügyfélhez.
GetHttpCode()	Lekéri a HTTP-válasz állapotkódját, hogy visszatérjen az ügyfélhez.
GetObjectData(SerializationInfo, StreamingContext)	Információt kap a kivételről, és hozzáadja az SerializationInfo objektumhoz.
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Ha felül van bírálva egy származtatott osztályban, a SerializationInfo kivétel adatait adja meg. (Öröklődés forrása Exception)
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	A hiba HRESULT értékét tartalmazó sztringet ad vissza. (Öröklődés forrása ExternalException)

esemény

Name	Description
SerializeObjectState	Elavult. Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?