Compartir a través de

HttpLoggingSection (clase1)

  • Artículo

Configura el registro de solicitudes HTTP.

Sintaxis

class HttpLoggingSection : ConfigurationSection

Métodos

En la tabla siguiente se enumeran los métodos que expone la clase HttpLoggingSection.

Nombre Descripción
GetAllowDefinition (Se hereda de ConfigurationSection).
GetAllowLocation (Se hereda de ConfigurationSection).
RevertToParent (Se hereda de ConfigurationSection).
SetAllowDefinition (Se hereda de ConfigurationSection).
SetAllowLocation (Se hereda de ConfigurationSection).

Propiedades

En la tabla siguiente se enumeran las propiedades que expone la clase HttpLoggingSection.

Nombre Descripción
DontLog Valor boolean de lectura y escritura. true si el registro está deshabilitado para solicitudes correctas; false si se registran solicitudes correctas. Una solicitud se considera correcta si su código de estado es inferior a 400. El valor predeterminado es false. Nota: Esta propiedad es la misma que la propiedad de metabase DontLog en IIS 6.0.
Location (Se hereda de ConfigurationSection). Una propiedad clave.
Path (Se hereda de ConfigurationSection). Una propiedad clave.
SectionInformation (Se hereda de ConfigurationSection).
SelectiveLogging Enumeración sint32 que especifica los eventos que se van a registrar. Los valores posibles se enumeran más adelante en la sección Comentarios.

Subclases

Esta clase no contiene subclases.

Comentarios

Esta clase corresponde a la sección <system.webServer/httpLogging> del archivo ApplicationHost.config.

En la siguiente tabla se describen los posibles valores de la propiedad SelectiveLogging. El valor predeterminado es 0 (LogAll).

Valor Palabra clave Descripción
0 LogAll Se registran todas las solicitudes.
1 LogSuccessful Solo se registran las solicitudes correctas. Una solicitud se considera correcta si su código de estado es inferior a 400.
2 LogError Solo se registran las solicitudes con errores. Se considera que se produjo un error en una solicitud si su código de estado es mayor o igual que 400.

Ejemplo

En el código de ejemplo siguiente se establece la propiedad SelectiveLogging en LogError.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the HTTP logging section.  
Set oSection = oWebAdmin.Get( _  
    "HttpLoggingSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]" & vbCrLf  
  
' Display the initial settings.  
Call DisplaySettings("Initial Values", oSection)  
  
' Set the SelectiveLogging property to LogError.  
    oSection.SelectiveLogging = 2  
  
' Save new values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with new values.  
oSection.Refresh_  
  
' Show changed settings.  
Call DisplaySettings("New Values", oSection)  
  
' ==== DisplaySettings helper function. ====  
Function DisplaySettings(HeadingText, oSection)  
  
    ' Display a heading.  
    WScript.Echo String(Len(HeadingText), "-")  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "-")  
  
    ' Display configuration history section properties.  
    WScript.Echo "Path: " & oSection.Path  
    WScript.Echo "Location: " & oSection.Location  
    WScript.Echo "DontLog: " & oSection.DontLog  
    WScript.Echo "SelectiveLogging: " & _  
        oSection.SelectiveLogging  
    WScript.Echo  
End Function

Jerarquía de herencia

ConfigurationSection

HttpLoggingSection

Requisitos

Tipo Descripción
Remoto - IIS 7.0 en Windows Vista
- IIS 7.5 en Windows 7
- IIS 8.0 en Windows 8
- IIS 10.0 en Windows 10
Server - IIS 7.0 en Windows Server 2008
- IIS 7.5 en Windows Server 2008 R2
- IIS 8.0 en Windows Server 2012
- IIS 8.5 en Windows Server 2012 R2
- IIS 10.0 en Windows Server 2016
Producto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF WebAdministration.mof

Consulte también

CentralBinaryLogFile (clase)
CentralW3CLogFile (clase)
ConfigurationSection (clase)
OdbcLoggingSection (clase)
LogSection (clase)
SiteLogFile (clase)
DontLog Metabase (propiedad) (IIS 6.0)