HttpResponse.SubStatusCode Propriété

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Obtient ou définit une valeur qui qualifie le code d'état de la réponse.

public:
 property int SubStatusCode { int get(); void set(int value); };

public int SubStatusCode { get; set; }

member this.SubStatusCode : int with get, set

Public Property SubStatusCode As Integer

Valeur de propriété

Int32

Valeur entière qui représente le code de sous-status IIS 7.0.

Exceptions

PlatformNotSupportedException

L’opération nécessite le mode pipeline intégré dans IIS 7.0 et au moins le .NET Framework version 3.0.

HttpException

Le code d'état est défini une fois que tous les en-têtes HTTP ont été envoyés.

Exemples

L’exemple suivant définit la SubStatusCode propriété dans un gestionnaire d’événements pour le HttpApplication instance de l’événementPostAuthenticateRequest. Placez le fichier de code dans le dossier App_Code de votre application web et configurez le fichier Web.config pour inscrire le module. Pour plus d’informations, consultez Procédure pas à pas : création et inscription d’un module HTTP personnalisé.

using System;
using System.Data;
using System.Web;
using System.Web.Security;
using System.Web.UI;

// Module that sets Response.SubStatusCode in PostAuthenticateRequest event handler.
namespace Samples
{
    public class ModuleExampleTestCS : IHttpModule
    {
        public ModuleExampleTestCS()
        {
            // Constructor
        }
        public void Init(HttpApplication app)
        {
            app.PostAuthenticateRequest += new EventHandler(PostAuthenticateRequest_Handler);
        }
        public void Dispose()
        {
        }
        public void PostAuthenticateRequest_Handler(object source, EventArgs e)
        {
            HttpApplication app = (HttpApplication)source;
            HttpContext context = app.Context;

            // Set a SubStatusCode for Failed Request Tracing in IIS7
            context.Response.SubStatusCode = 99;
        }
    }
}

Imports System.Data
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI

' Module that sets Response.SubStatusCode in PostAuthenticateRequest event handler.
Namespace Samples

    Public Class ModuleExampleTestVB
        Implements IHttpModule

        Public Sub New()
            ' Constructor
        End Sub

        Public Sub Init(ByVal app As HttpApplication) Implements IHttpModule.Init
            AddHandler app.PostAuthenticateRequest, AddressOf Me.PostAuthenticateRequest_Handler
        End Sub

        Public Sub Dispose() Implements IHttpModule.Dispose
        End Sub

        Public Sub PostAuthenticateRequest_Handler(ByVal source As Object, ByVal e As EventArgs)
            Dim app As HttpApplication = CType(source, HttpApplication)
            Dim context As HttpContext = app.Context

            ' Set a SubStatusCode for Failed Request Tracing in IIS7.
            context.Response.SubStatusCode = 99
        End Sub
    End Class

End Namespace

Remarques

La SubStatusCode propriété est uniquement prise en charge avec le mode de pipeline intégré dans IIS 7.0 et au moins le .NET Framework version 3.0. Lorsque vous définissez la SubStatusCode propriété, le status est enregistré sur IIS 7.0 si le suivi des demandes ayant échoué est configuré. Indépendamment de la configuration du suivi, le code n’est jamais envoyé dans le cadre de la réponse finale à la demande. Pour plus d’informations, consultez Résolution des problèmes de demandes ayant échoué à l’aide du suivi des demandes ayant échoué dans IIS 7.0.

Voir aussi

• StatusCode