HttpResponse.SubStatusCode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der den Statuscode der Antwort qualifiziert.
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
Ein ganzzahliger Wert, der den IIS 7.0-Unterstatuscode darstellt.
Ausnahmen
Für den Vorgang ist der integrierte Pipelinemodus in IIS 7.0 und mindestens die .NET Framework-Version 3.0 erforderlich.
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 Instanz des PostAuthenticateRequest Ereignisses festgelegt. Legen Sie die Codedatei in den Ordner App_Code Ihrer Webanwendung ein, 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 der Status bei IIS 7.0 protokolliert, wenn die Ablaufverfolgung fehlgeschlagener Anforderungen 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 Problembehandlung bei fehlgeschlagenen Anforderungen mithilfe der Ablaufverfolgung fehlgeschlagener Anforderungen in IIS 7.0.