HttpResponse.SubStatusCode Właściwość

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Pobiera lub ustawia wartość kwalifikującą kod stanu odpowiedzi.

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

Wartość właściwości

Int32

Wartość całkowita reprezentująca kod stanu podrzędnego usług IIS 7.0.

Wyjątki

PlatformNotSupportedException

Operacja wymaga zintegrowanego trybu potoku w usługach IIS 7.0 i co najmniej .NET Framework w wersji 3.0.

HttpException

Kod stanu jest ustawiany po wysłaniu wszystkich nagłówków HTTP.

Przykłady

Poniższy przykład ustawia SubStatusCode właściwość w procedurze obsługi zdarzeń dla HttpApplication wystąpienia PostAuthenticateRequest zdarzenia. Umieść plik kodu w folderze App_Code aplikacji internetowej i skonfiguruj plik Web.config w celu zarejestrowania modułu. Aby uzyskać więcej informacji, zobacz Przewodnik: tworzenie i rejestrowanie niestandardowego modułu HTTP.

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

Uwagi

Właściwość jest obsługiwana SubStatusCode tylko w trybie zintegrowanego potoku w usługach IIS 7.0 i co najmniej .NET Framework w wersji 3.0. Po ustawieniu SubStatusCode właściwości stan jest rejestrowany w usługach IIS 7.0, jeśli śledzenie żądań nie powiodło się. Niezależnie od tego, czy śledzenie jest skonfigurowane, kod nigdy nie jest wysyłany w ramach ostatecznej odpowiedzi na żądanie. Aby uzyskać więcej informacji, zobacz Troubleshooting Failed Requests Using Failed Request Tracing in IIS 7.0 (Rozwiązywanie problemów z nieudanym żądaniem przy użyciu śledzenia niepomyślnych żądań w usługach IIS 7.0).

Zobacz też

• StatusCode