HttpResponse.SubStatusCode 속성

정의

네임스페이스:

System.Web

어셈블리:

System.Web.dll

응답의 상태 코드를 한정하는 값을 가져오거나 설정합니다.

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

속성 값

Int32

IIS 7.0 하위 상태 코드를 나타내는 정수 값입니다.

예외

PlatformNotSupportedException

이 작업을 수행하려면 IIS 7.0 및 .NET Framework 버전 3.0 이상의 통합 파이프라인 모드가 필요합니다.

HttpException

상태 코드는 모든 HTTP 헤더를 보낸 후에 설정됩니다.

예제

다음 예에서는 이벤트 인스턴스 PostAuthenticateRequest 에 대한 HttpApplication 이벤트 처리기의 속성을 설정합니다SubStatusCode. 웹 애플리케이션의 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에서 실패한 요청 추적을 사용하여 실패한 요청 문제 해결을 참조하세요.

추가 정보

• StatusCode