Language

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 ヘッダーが送信された後に設定されます。

例

次の例では、SubStatusCode イベントのHttpApplication インスタンスのイベント ハンドラーにPostAuthenticateRequest プロパティを設定します。 コード ファイルを 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 の失敗した要求トレースを使用した失敗した要求のトラブルシューティング」を参照してください。

適用対象

こちらもご覧ください