HttpException Classe

Definição

Espaço de Nomes:: System.Web

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Descreve uma exceção que ocorreu durante o processamento de pedidos HTTP.

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

Herança: Object

Exception

SystemException

ExternalException
HttpException

Derivado: System.Web.HttpCompileException

System.Web.HttpParseException

System.Web.HttpRequestValidationException

System.Web.HttpUnhandledException

Atributos: SerializableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar a HttpException classe para criar exceções personalizadas. O Button_Click método determina qual botão foi pressionado e depois chama o CheckNumber método ou CheckBoolean . Se o valor introduzido pelo utilizador na caixa de texto não corresponder ao tipo esperado, cria-se uma HttpException exceção e é lançada com uma mensagem personalizada com base no tipo de erro.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

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

Observações

A classe HttpException é uma classe de exceção específica para HTTP que permite ASP.NET gerar informação sobre exceções. Para mais informações sobre lançamento e gestão de exceções, veja Exceções.

Construtores

Name	Description
HttpException()	Inicializa uma nova instância da HttpException classe e cria um objeto vazio HttpException .
HttpException(Int32, String, Exception)	Inicializa uma nova instância da HttpException classe usando um código de estado de resposta HTTP, uma mensagem de erro e a InnerException propriedade.
HttpException(Int32, String, Int32)	Inicializa uma nova instância da HttpException classe usando um código de estado de resposta HTTP, uma mensagem de erro e um código de exceção.
HttpException(Int32, String)	Inicializa uma nova instância da HttpException classe usando um código de estado de resposta HTTP e uma mensagem de erro.
HttpException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da HttpException classe com dados serializados.
HttpException(String, Exception)	Inicializa uma nova instância da HttpException classe usando uma mensagem de erro e a InnerException propriedade.
HttpException(String, Int32)	Inicializa uma nova instância da HttpException classe usando uma mensagem de erro e um código de exceção.
HttpException(String)	Inicializa uma nova instância da HttpException classe usando uma mensagem de erro fornecida.

Propriedades

Name	Description
Data	Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception)
ErrorCode	Obtém o `HRESULT` erro do erro. (Herdado de ExternalException)
HelpLink	Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception)
HResult	Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a Exception instância que causou a exceção atual. (Herdado de Exception)
Message	Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que lança a exceção atual. (Herdado de Exception)
WebEventCode	Obtém os códigos de evento associados à exceção HTTP.

Métodos

Name	Description
CreateFromLastError(String)	Cria uma nova exceção HttpException com base no código de erro que é devolvido pelo método `GetLastError()` da API Windows.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetHtmlErrorMessage()	Recebe a mensagem de erro HTML para devolver ao cliente.
GetHttpCode()	Recebe o código de estado da resposta HTTP para devolver ao cliente.
GetObjectData(SerializationInfo, StreamingContext)	Obtém informação sobre a exceção e adiciona-a ao SerializationInfo objeto.
GetObjectData(SerializationInfo, StreamingContext)	Quando sobreposto numa classe derivada, define a SerializationInfo informação com sobre a exceção. (Herdado de Exception)
GetType()	Obtém o tipo de execução da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Devolve uma string que contém o HRESULT do erro. (Herdado de ExternalException)

evento

Name	Description
SerializeObjectState	Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)

Aplica-se a

Ver também

Comentários

Esta página foi útil?