HttpException Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Descrive un'eccezione che si è verificata durante l'elaborazione delle richieste 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

Ereditarietà: Object

Exception

SystemException

ExternalException
HttpException

Derivato: System.Web.HttpCompileException

System.Web.HttpParseException

System.Web.HttpRequestValidationException

System.Web.HttpUnhandledException

Attributi: SerializableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare la HttpException classe per generare eccezioni personalizzate. Il Button_Click metodo determina quale pulsante è stato fatto clic e quindi chiama il CheckNumber metodo o CheckBoolean . Se il valore immesso dall'utente nella casella di testo non corrisponde al tipo previsto, HttpException viene creata un'eccezione e generata con un messaggio personalizzato in base al tipo di errore.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.

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

Commenti

La HttpException classe è una classe di eccezione specifica HTTP che consente ASP.NET di generare informazioni sull'eccezione. Per altre informazioni sulla generazione e la gestione delle eccezioni, vedere Eccezioni.

Costruttori

HttpException()	Inizializza una nuova istanza della classe HttpException e crea un oggetto HttpException vuoto.
HttpException(Int32, String)	Inizializza una nuova istanza della classe HttpException usando un codice di stato della risposta HTTP e un messaggio di errore.
HttpException(Int32, String, Exception)	Inizializza una nuova istanza della classe HttpException usando un codice di stato della risposta HTTP, un messaggio di errore e la proprietà InnerException.
HttpException(Int32, String, Int32)	Inizializza una nuova istanza della classe HttpException usando un codice di stato della risposta HTTP, un messaggio di errore e un codice di eccezione.
HttpException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della classe HttpException con dati serializzati.
HttpException(String)	Inizializza una nuova istanza della classe HttpException usando un messaggio di errore specificato.
HttpException(String, Exception)	Inizializza una nuova istanza della classe HttpException usando un messaggio di errore e la proprietà InnerException.
HttpException(String, Int32)	Inizializza una nuova istanza della classe HttpException usando un messaggio di errore e un codice di eccezione.

Proprietà

Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
ErrorCode	Ottiene l'oggetto `HRESULT` dell'errore. (Ereditato da ExternalException)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)
WebEventCode	Ottiene i codici di evento associati all'eccezione HTTP.

Metodi

CreateFromLastError(String)	Crea una nuova eccezione HttpException basata sul codice di errore restituito dal metodo `GetLastError()` API Windows.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHtmlErrorMessage()	Ottiene il messaggio di errore HTML da restituire al client.
GetHttpCode()	Ottiene il codice di stato della risposta HTTP da restituire al client.
GetObjectData(SerializationInfo, StreamingContext)	Ottiene informazioni sull'eccezione e le aggiunge all'oggetto SerializationInfo.
GetObjectData(SerializationInfo, StreamingContext)	Quando ne viene eseguito l'override in una classe derivata, imposta il controllo SerializationInfo con le informazioni sull'eccezione. (Ereditato da Exception)
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa contenente il valore HRESULT dell'errore. (Ereditato da ExternalException)

Eventi

SerializeObjectState

Obsoleti.

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.

(Ereditato da Exception)

Si applica a