HttpResponse.SubStatusCode Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que qualifica o código de estado da resposta.
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
Valor de Propriedade
Um valor inteiro que representa o subcódigo de estado do IIS 7.0.
Exceções
A operação requer o modo pipeline integrado no IIS 7.0 e pelo menos o .NET Framework versão 3.0.
O código de estado é definido depois de todos os cabeçalhos HTTP terem sido enviados.
Exemplos
O exemplo seguinte define a SubStatusCode propriedade num gestor de eventos para a HttpApplication instância do PostAuthenticateRequest evento. Coloque o ficheiro de código na pasta App_Code da sua aplicação Web e configure o ficheiro Web.config para registar o módulo. Para mais informações, consulte Guia: Criação e Registo de um Módulo HTTP Personalizado.
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
Observações
A propriedade SubStatusCode é suportada apenas com o modo pipeline integrado no IIS 7.0 e pelo menos no .NET Framework versão 3.0. Quando defines a SubStatusCode propriedade, o estado é registado no IIS 7.0 se o rastreio de pedidos falhados estiver configurado. Independentemente de o rastreamento estar configurado, o código nunca é enviado como parte da resposta final ao pedido. Para mais informações, consulte Resolução de Problemas de Pedidos Falhados Usando Rastreamento de Pedidos Falhados no IIS 7.0.