HttpResponse.SubStatusCode Proprietà

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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à

Int32

Valore intero che rappresenta il codice di stato secondario IIS 7.0.

Eccezioni

PlatformNotSupportedException

L'operazione richiede la modalità pipeline integrata in IIS 7.0 e almeno .NET Framework versione 3.0.

HttpException

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.

Vedi anche

• StatusCode