HttpResponse.SubStatusCode Eigenschaft

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Ruft einen Wert ab, der den Statuscode der Antwort qualifiziert, oder legt diesen fest.

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

Eigenschaftswert

Int32

Ein ganzzahliger Wert, der den IIS 7.0-Status-Code darstellt.

Ausnahmen

PlatformNotSupportedException

Der Vorgang erfordert den integrierten Pipelinemodus in IIS 7.0 und mindestens die .NET Framework Version 3.0.

HttpException

Der Statuscode wird festgelegt, nachdem alle HTTP-Header gesendet wurden.

Beispiele

Im folgenden Beispiel wird die SubStatusCode -Eigenschaft in einem Ereignishandler für die HttpApplication instance des PostAuthenticateRequest Ereignisses festgelegt. Speichern Sie die Codedatei im Ordner App_Code Ihrer Webanwendung, und konfigurieren Sie die Web.config-Datei, um das Modul zu registrieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen und Registrieren eines benutzerdefinierten HTTP-Moduls.

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

Hinweise

Die SubStatusCode -Eigenschaft wird nur mit dem integrierten Pipelinemodus in IIS 7.0 und mindestens der .NET Framework Version 3.0 unterstützt. Wenn Sie die SubStatusCode -Eigenschaft festlegen, wird die status in IIS 7.0 protokolliert, wenn die Ablaufverfolgung für Anforderungsfehler konfiguriert ist. Unabhängig davon, ob die Ablaufverfolgung konfiguriert ist, wird der Code nie als Teil der endgültigen Antwort an die Anforderung gesendet. Weitere Informationen finden Sie unter Troubleshooting Failed Requests Using Failed Request Tracing in IIS 7.0.

Weitere Informationen

• StatusCode