HttpResponse.SubStatusCode HttpResponse.SubStatusCode HttpResponse.SubStatusCode HttpResponse.SubStatusCode Property

Definición

Obtiene o establece un valor que califica el código de estado de la respuesta.Gets or sets a value qualifying the status code of the response.

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

Valor entero que representa el código de subestado de IIS 7.0IIS 7.0.An integer value that represents the IIS 7.0IIS 7.0 sub status code.

Excepciones

La operación requiere el modo de canalización integrada en IIS 7.0IIS 7.0 y al menos la versión 3.0 de .NET Framework.The operation requires the integrated pipeline mode in IIS 7.0IIS 7.0 and at least the .NET Framework version 3.0.

El código de estado se establece después de haber enviado todos los encabezados HTTP.The status code is set after all HTTP headers have been sent.

Ejemplos

En el ejemplo siguiente se SubStatusCode establece la propiedad en un controlador de HttpApplication eventos para la PostAuthenticateRequest instancia del evento.The following example sets the SubStatusCode property in an event handler for the HttpApplication instance of the PostAuthenticateRequest event. 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.Put the code file in the App_Code folder of your Web application and configure the Web.config file to register the module. Para obtener más información, vea Tutorial: Crear y registrar un módulohttp personalizado.For more information, see Walkthrough: Creating and Registering a Custom HTTP Module.

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 IIS 7.0IIS 7.0 integrada en y al menos la .NET Framework versión 3,0.The SubStatusCode property is only supported with the integrated pipeline mode in IIS 7.0IIS 7.0 and at least the .NET Framework version 3.0. Cuando se establece la SubStatusCode propiedad, el estado se IIS 7.0IIS 7.0 inicia cuando se configura el seguimiento de solicitudes con error.When you set the SubStatusCode property, the status is logged on IIS 7.0IIS 7.0 if failed-request tracing is configured. Independientemente de si se configura el seguimiento, el código nunca se envía como parte de la respuesta final a la solicitud.Independent of whether tracing is configured, the code is never sent as part of the final response to the request. Para obtener más información, vea solucionar problemas de solicitudes con error con el seguimiento de solicitudes con error en IIS 7,0.For more information, see Troubleshooting Failed Requests Using Failed Request Tracing in IIS 7.0.

Se aplica a

Consulte también: