HttpResponse.SubStatusCode Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
Valeur entière qui représente le code de sous-status IIS 7.0.
Exceptions
L’opération nécessite le mode pipeline intégré dans IIS 7.0 et au moins le .NET Framework version 3.0.
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.