HttpResponse.SubStatusCode Proprietà
Definizione
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.
Ottiene o imposta un valore che qualifica il codice di stato della risposta.
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
Valore della proprietà
Valore intero che rappresenta il codice di stato secondario IIS 7.0.
Eccezioni
L'operazione richiede la modalità pipeline integrata in IIS 7.0 e almeno .NET Framework versione 3.0.
Il codice di stato viene impostato dopo l'invio di tutte le intestazioni HTTP.
Esempio
Nell'esempio seguente viene impostata la SubStatusCode proprietà in un gestore eventi per l'istanza HttpApplication dell'evento PostAuthenticateRequest . Inserire il file di codice nella cartella App_Code dell'applicazione Web e configurare il file Web.config per registrare il modulo. Per altre informazioni, vedere Procedura dettagliata: Creazione e registrazione di un modulo HTTP personalizzato.
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
Commenti
La SubStatusCode proprietà è supportata solo con la modalità pipeline integrata in IIS 7.0 e almeno con .NET Framework versione 3.0. Quando si imposta la SubStatusCode proprietà, lo stato viene registrato in IIS 7.0 se la traccia delle richieste non riuscite è configurata. Indipendentemente dal fatto che la traccia sia configurata, il codice non viene mai inviato come parte della risposta finale alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle richieste non riuscite tramite la traccia delle richieste non riuscite in IIS 7.0.