HttpResponse.SubStatusCode Vlastnost

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu kvalifikující stavový kód odpovědi.

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

Hodnota vlastnosti

Int32

Celočíselná hodnota, která představuje dílčí stavový kód služby IIS 7.0.

Výjimky

PlatformNotSupportedException

Operace vyžaduje režim integrovaného kanálu ve službě IIS 7.0 a minimálně v rozhraní .NET Framework verze 3.0.

HttpException

Stavový kód se nastaví po odeslání všech hlaviček HTTP.

Příklady

Následující příklad nastaví SubStatusCode vlastnost v obslužné rutině události pro HttpApplication instanci PostAuthenticateRequest události. Vložte soubor kódu do složky App_Code webové aplikace a nakonfigurujte soubor Web.config pro registraci modulu. Další informace najdete v tématu Návod: Vytvoření a registrace vlastního modulu 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

Poznámky

Vlastnost SubStatusCode je podporována pouze v integrovaném režimu kanálu ve službě IIS 7.0 a minimálně v rozhraní .NET Framework verze 3.0. Když nastavíte SubStatusCode vlastnost, stav se protokoluje ve službě IIS 7.0, pokud je nakonfigurováno trasování neúspěšných požadavků. Bez ohledu na to, jestli je nakonfigurované trasování, se kód nikdy neodesílá jako součást konečné odpovědi na požadavek. Další informace najdete v tématu Řešení potíží s neúspěšnými požadavky pomocí trasování neúspěšných požadavků ve službě IIS 7.0.

Platí pro

Viz také

StatusCode