Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

HttpException, classe

Décrit une exception qui s'est produite pendant le traitement de demandes HTTP.

Espace de noms :  System.Web
Assembly :  System.Web (dans System.Web.dll)
[SerializableAttribute]
public class HttpException : ExternalException

Le type HttpException expose les membres suivants.

  NomDescription
Méthode publiqueHttpException()Initialise une nouvelle instance de la classe HttpException et crée un objet HttpException vide.
Méthode publiqueHttpException(String)Initialise une nouvelle instance de la classe HttpException à l'aide du message d'erreur fourni.
Méthode publiqueHttpException(Int32, String)Initialise une nouvelle instance de la classe HttpException à l'aide d'un code d'état de réponse HTTP et d'un message d'erreur.
Méthode protégéeHttpException(SerializationInfo, StreamingContext)Initialise une nouvelle instance de la classe HttpException avec des données sérialisées.
Méthode publiqueHttpException(String, Exception)Initialise une nouvelle instance de la classe HttpException avec le message d'erreur spécifié et la propriété InnerException.
Méthode publiqueHttpException(String, Int32)Initialise une nouvelle instance de la classe HttpException avec un message d'erreur et un code d'exception.
Méthode publiqueHttpException(Int32, String, Exception)Initialise une nouvelle instance de la classe HttpException à l'aide d'un code d'état de réponse HTTP, d'un message d'erreur et de la propriété InnerException.
Méthode publiqueHttpException(Int32, String, Int32)Initialise une nouvelle instance de la classe HttpException à l'aide d'un code d'état de réponse HTTP, d'un message d'erreur et d'un code d'exception.
Début
  NomDescription
Propriété publiqueDataObtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l'utilisateur sur l'exception. (Hérité de Exception.)
Propriété publiqueErrorCodeObtient le HRESULT de l'erreur. (Hérité de ExternalException.)
Propriété publiqueHelpLinkObtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception.)
Propriété publiqueHResultObtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception.)
Propriété publiqueInnerExceptionObtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception.)
Propriété publiqueMessageObtient un message qui décrit l'exception actuelle. (Hérité de Exception.)
Propriété publiqueSourceObtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception.)
Propriété publiqueStackTraceObtient une représentation sous forme de chaîne des frames immédiates sur la pile des appels. (Hérité de Exception.)
Propriété publiqueTargetSiteObtient la méthode qui lève l'exception actuelle. (Hérité de Exception.)
Propriété publiqueWebEventCodeObtient les codes d'événement associés à l'exception HTTP.
Début
  NomDescription
Méthode publiqueMembre statiqueCreateFromLastErrorCrée une exception HttpException fondée sur le code d'erreur retourné à partir de la méthode de l'API Win32 GetLastError().
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize 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.)
Méthode publiqueGetBaseExceptionEn cas de substitution dans une classe dérivée, retourne Exception qui est à l'origine d'une ou de plusieurs exceptions suivantes. (Hérité de Exception.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetHtmlErrorMessageObtient le message d'erreur HTML à retourner au client.
Méthode publiqueGetHttpCodeObtient le code d'état de réponse HTTP à retourner au client.
Méthode publiqueGetObjectDataObtient des informations sur l'exception et les ajoute à l'objet SerializationInfo. (Substitue Exception.GetObjectData(SerializationInfo, StreamingContext).)
Méthode publiqueGetTypeObtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueToStringRetourne une chaîne qui contient le HRESULT de l'erreur. (Hérité de ExternalException.)
Début
  NomDescription
Événement protégéSerializeObjectStateSe produit lorsqu'une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées relatives à l'exception. (Hérité de Exception.)
Début

La classe HttpException 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 d'exceptions, consultez Gestion et levée des exceptions.

L'exemple de code suivant illustre l'utilisation de la classe HttpException pour lever des exceptions personnalisées. La méthode Button_Click détermine quel bouton a été activé, puis appelle la méthode CheckNumber ou CheckBoolean. Si la valeur entrée par utilisateur dans la zone de texte ne correspond pas au type attendu, une exception HttpException est créée, puis levée avec un message personnalisé fondé sur le type d'erreur.

Note de sécuritéNote de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent 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

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tout membre static (Shared en Visual Basic) public de ce type est thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.