HttpResponse.SubStatusCode Propiedad

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Obtiene o establece un valor que califica el código de estado de la respuesta.

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 propiedad

Int32

Valor entero que representa el código de subestado de IIS 7.0.

Excepciones

PlatformNotSupportedException

La operación requiere el modo de canalización integrado en IIS 7.0 y al menos la versión 3.0 de .NET Framework.

HttpException

El código de estado se establece después de haber enviado todos los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se establece la SubStatusCode propiedad en un controlador de eventos para la HttpApplication instancia del PostAuthenticateRequest evento. Coloque el archivo de código en la carpeta App_Code de la aplicación web y configure el archivo Web.config para registrar el módulo. Para obtener más información, vea Tutorial: Crear y registrar un 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

Comentarios

La SubStatusCode propiedad solo se admite con el modo de canalización integrada en IIS 7.0 y al menos con la versión 3.0 de .NET Framework. Al establecer la SubStatusCode propiedad , el estado se registra en IIS 7.0 si se configura el seguimiento de solicitudes con error. Independientemente de si se configura el seguimiento, el código nunca se envía como parte de la respuesta final a la solicitud. Para obtener más información, consulte Solución de problemas de solicitudes con errores mediante el seguimiento de solicitudes con error en IIS 7.0.

Consulte también

• StatusCode