HttpException Klass

Definition

Namnområde:: System.Web

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Beskriver ett undantag som inträffade under bearbetningen av HTTP-begäranden.

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

Arv: Object

Exception

SystemException

ExternalException
HttpException

Härledda: System.Web.HttpCompileException

System.Web.HttpParseException

System.Web.HttpRequestValidationException

System.Web.HttpUnhandledException

Attribut: SerializableAttribute

Exempel

Följande kodexempel visar hur du använder HttpException klassen för att skapa anpassade undantag. Metoden Button_Click avgör vilken knapp som klickades och anropar sedan antingen CheckNumber metoden eller CheckBoolean . Om det användarangivna värdet i textrutan inte motsvarar den förväntade typen skapas ett HttpException undantag och genereras med ett anpassat meddelande baserat på feltypen.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

Klassen HttpException är en HTTP-specifik undantagsklass som gör att ASP.NET kan generera undantagsinformation. Mer information om hur du genererar och hanterar undantag finns i Undantag.

Konstruktorer

Name	Description
HttpException()	Initierar en ny instans av HttpException klassen och skapar ett tomt HttpException objekt.
HttpException(Int32, String, Exception)	Initierar en ny instans av klassen med hjälp av HttpException en HTTP-svarsstatuskod, ett felmeddelande och egenskapen InnerException .
HttpException(Int32, String, Int32)	Initierar en ny instans av klassen med hjälp av HttpException en HTTP-svarsstatuskod, ett felmeddelande och en undantagskod.
HttpException(Int32, String)	Initierar en ny instans av klassen med hjälp av HttpException en HTTP-svarsstatuskod och ett felmeddelande.
HttpException(SerializationInfo, StreamingContext)	Initierar en ny instans av HttpException klassen med serialiserade data.
HttpException(String, Exception)	Initierar en ny instans av klassen med hjälp av HttpException ett felmeddelande och egenskapen InnerException .
HttpException(String, Int32)	Initierar en ny instans av klassen med hjälp av HttpException ett felmeddelande och en undantagskod.
HttpException(String)	Initierar en ny instans av klassen med hjälp av HttpException ett angivet felmeddelande.

Egenskaper

Name	Description
Data	Hämtar en samling nyckel/värde-par som ger ytterligare användardefinierad information om undantaget. (Ärvd från Exception)
ErrorCode	`HRESULT` Hämtar felet. (Ärvd från ExternalException)
HelpLink	Hämtar eller anger en länk till hjälpfilen som är associerad med det här undantaget. (Ärvd från Exception)
HResult	Hämtar eller anger HRESULT, ett kodat numeriskt värde som har tilldelats ett specifikt undantag. (Ärvd från Exception)
InnerException	Hämtar den Exception instans som orsakade det aktuella undantaget. (Ärvd från Exception)
Message	Hämtar ett meddelande som beskriver det aktuella undantaget. (Ärvd från Exception)
Source	Hämtar eller anger namnet på programmet eller objektet som orsakar felet. (Ärvd från Exception)
StackTrace	Hämtar en strängrepresentation av de omedelbara ramarna i anropsstacken. (Ärvd från Exception)
TargetSite	Hämtar den metod som utlöser det aktuella undantaget. (Ärvd från Exception)
WebEventCode	Hämtar de händelsekoder som är associerade med HTTP-undantaget.

Metoder

Name	Description
CreateFromLastError(String)	Skapar ett nytt HttpException undantag baserat på felkoden som returneras från metoden Windows API `GetLastError()`.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetBaseException()	När den åsidosätts i en härledd klass returnerar den Exception som är rotorsaken till ett eller flera efterföljande undantag. (Ärvd från Exception)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetHtmlErrorMessage()	Hämtar HTML-felmeddelandet för att återgå till klienten.
GetHttpCode()	Hämtar http-svarsstatuskoden för att återgå till klienten.
GetObjectData(SerializationInfo, StreamingContext)	Hämtar information om undantaget och lägger till det i SerializationInfo objektet.
GetObjectData(SerializationInfo, StreamingContext)	När åsidosättas i en härledd klass anger du SerializationInfo med information om undantaget. (Ärvd från Exception)
GetType()	Hämtar körningstypen för den aktuella instansen. (Ärvd från Exception)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ToString()	Returnerar en sträng som innehåller HRESULT för felet. (Ärvd från ExternalException)

Händelser

Name	Description
SerializeObjectState	Inträffar när ett undantag serialiseras för att skapa ett undantagstillståndsobjekt som innehåller serialiserade data om undantaget. (Ärvd från Exception)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?