Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpException classe

 

Date de publication : novembre 2016

Décrit une exception qui s’est produite lors du traitement de requêtes HTTP.

Espace de noms:   System.Web
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Web.HttpException
          System.Web.HttpCompileException
          System.Web.HttpParseException
          System.Web.HttpRequestValidationException
          System.Web.HttpUnhandledException

[SerializableAttribute]
public class HttpException : ExternalException

NomDescription
System_CAPS_pubmethodHttpException()

Initialise une nouvelle instance de la HttpException classe et crée un vide HttpException objet.

System_CAPS_pubmethodHttpException(Int32, String)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un code d’état de réponse HTTP et un message d’erreur.

System_CAPS_pubmethodHttpException(Int32, String, Exception)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un code d’état HTTP de réponse, un message d’erreur et le InnerException propriété.

System_CAPS_pubmethodHttpException(Int32, String, Int32)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un code d’état de réponse HTTP, un message d’erreur et un code d’exception.

System_CAPS_protmethodHttpException(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe HttpException avec des données sérialisées.

System_CAPS_pubmethodHttpException(String)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un message d’erreur fourni.

System_CAPS_pubmethodHttpException(String, Exception)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un message d’erreur et le InnerException propriété.

System_CAPS_pubmethodHttpException(String, Int32)

Initialise une nouvelle instance de la HttpException classe à l’aide d’un message d’erreur et un code d’exception.

NomDescription
System_CAPS_pubpropertyData

Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l’utilisateur sur l’exception.(Hérité de Exception.)

System_CAPS_pubpropertyErrorCode

Obtient le HRESULT de l’erreur.(Hérité de ExternalException.)

System_CAPS_pubpropertyHelpLink

Obtient ou définit un lien vers le fichier d'aide associé à cette exception.(Hérité de Exception.)

System_CAPS_pubpropertyHResult

Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique.(Hérité de Exception.)

System_CAPS_pubpropertyInnerException

Obtient l'instance Exception qui a provoqué l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertyMessage

Obtient un message qui décrit l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertySource

Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur.(Hérité de Exception.)

System_CAPS_pubpropertyStackTrace

Obtient une représentation sous forme de chaîne des objets immédiats sur la pile des appels. (Hérité de Exception.)

System_CAPS_pubpropertyTargetSite

Obtient la méthode qui lève l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertyWebEventCode

Obtient les codes d’événement qui sont associés à l’exception HTTP.

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticCreateFromLastError(String)

Crée un nouveau HttpException exception basée sur le code d’erreur retourné par l’API Win32 GetLastError() méthode.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetBaseException()

En cas de substitution dans une classe dérivée, retourne la Exception qui est à l'origine d'une ou de plusieurs exceptions ultérieures.(Hérité de Exception.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetHtmlErrorMessage()

Obtient le message d’erreur HTML à retourner au client.

System_CAPS_pubmethodGetHttpCode()

Obtient le code d’état de réponse HTTP à retourner au client.

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Obtient des informations sur l’exception et l’ajoute à la SerializationInfo objet.(Remplace Exception.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetType()

Obtient le type au moment de l'exécution de l'instance actuelle.(Hérité de Exception.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui contient le HRESULT de l’erreur.(Hérité de ExternalException.)

NomDescription
System_CAPS_proteventSerializeObjectState

Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception.(Hérité de Exception.)

La HttpException classe est une classe d’exception spécifique à HTTP qui permet à ASP.NET de générer des informations sur les exceptions. Pour plus d’informations sur la levée et la gestion des exceptions, consultez Gestion et levée des exceptions.

L’exemple de code suivant montre comment utiliser la HttpException classe pour lever des exceptions personnalisées. Le Button_Click méthode détermine quel bouton l’utilisateur a cliqué, puis appelle le CheckNumber ou CheckBoolean (méthode). Si la valeur entrée par l’utilisateur dans la zone de texte ne correspond pas au type attendu, une HttpException exception est créée et levée avec un message personnalisé basé sur le type d’erreur.

System_CAPS_security Sécurité Remarque

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ou d'éléments HTML. Pour plus d'informations, consultez 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>

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: