HttpLoggingSection Class1

Configura o log de solicitações HTTP.

Sintaxe

class HttpLoggingSection : ConfigurationSection  

Métodos

A tabela a seguir lista os métodos expostos pela classe HttpLoggingSection.

Nome	Descrição
GetAllowDefinition	(Herdado de ConfigurationSection.)
GetAllowLocation	(Herdado de ConfigurationSection.)
RevertToParent	(Herdado de ConfigurationSection.)
SetAllowDefinition	(Herdado de ConfigurationSection.)
SetAllowLocation	(Herdado de ConfigurationSection.)

Propriedades

A tabela a seguir lista as propriedades expostas pela classe HttpLoggingSection.

Nome	Descrição
DontLog	Um valor boolean de leitura/gravação. true, se o registro estiver desabilitado para solicitações bem-sucedidas; false, se as solicitações bem-sucedidas forem registradas. Uma solicitação será considerada bem-sucedida se o código de status for menor que 400. O padrão é false. Observação: esta propriedade é igual à propriedade de metabase DontLog no IIS 6.0.
Location	(Herdado de ConfigurationSection.) Uma propriedade chave.
Path	(Herdado de ConfigurationSection.) Uma propriedade chave.
SectionInformation	(Herdado de ConfigurationSection.)
SelectiveLogging	Uma enumeração sint32 que especifica os eventos a serem registrados. Os valores possíveis estão listados posteriormente na seção Comentários.

Subclasses

Essa classe não contém subclasses.

Comentários

Essa classe corresponde à seção <system.webServer/httpLogging> no arquivo ApplicationHost.config.

A tabela a seguir lista os possíveis valores da propriedade SelectiveLogging. O padrão é 0 (LogAll).

Valor	Palavra-chave	Descrição
0	LogAll	Todas as solicitações são registradas.
1	LogSuccessful	Somente solicitações bem-sucedidas são registradas. Uma solicitação será considerada bem-sucedida se o código de status for menor que 400.
2	LogError	Somente solicitações com falha são registradas. Uma solicitação será considerada com falha se o código de status for maior ou igual a 400.

Exemplo

O exemplo de código a seguir define a propriedade SelectiveLogging como 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  
  

Hierarquia de herança

ConfigurationSection

HttpLoggingSection

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe ConfigurationSection
Classe OdbcLoggingSection
Classe LogSection
Classe SiteLogFile
Propriedade DontLog Metabase (IIS 6.0)