HttpResponse.SubStatusCode 属性

定义

获取或设置一个限定响应的状态代码的值。

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

属性值

表示 IIS 7.0 子状态代码的整数值。

例外

该操作需要 IIS 7.0 中的集成管道模式,至少需要.NET Framework版本 3.0。

状态代码在发送完所有 HTTP 标头之后设置。

示例

以下示例在事件实例的PostAuthenticateRequest事件处理程序HttpApplication中设置 SubStatusCode 属性。 将代码文件放在 Web 应用程序的 App_Code 文件夹中,并将 Web.config 文件配置为注册模块。 有关详细信息,请参阅 演练:创建和注册自定义 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

注解

SubStatusCode只有 IIS 7.0 中的集成管道模式和至少.NET Framework版本 3.0 才支持 属性。 设置 SubStatusCode 属性时,如果配置了失败的请求跟踪,则会在 IIS 7.0 上记录状态。 与是否配置跟踪无关,代码永远不会作为对请求的最终响应的一部分发送。 有关详细信息,请参阅 在 IIS 7.0 中使用失败的请求跟踪排查失败的请求问题。

适用于

另请参阅