Compartilhar via

LogSection Class1

  • Artigo

Configura o log para um servidor ou site.

Sintaxe

class LogSection : ConfigurationSection

Métodos

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

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 LogSection.

Nome Descrição
CentralBinaryLogFile Um valor CentralBinaryLogFile de leitura/gravação que especifica a configuração de log binário centralizado para todos os sites em um servidor.
CentralLogFileMode Um valor sint32 de leitura/gravação que especifica o modo de log centralizado para o servidor. Os valores possíveis estão listados posteriormente na seção Comentários.
CentralW3CLogFile Um valor CentralW3CLogFile de leitura/gravação que especifica a configuração de log centralizado do W3C (World Wide Web Consortium) para todos os sites em um servidor.
Location (Herdado de ConfigurationSection.) Uma propriedade chave.
LogInUTF8 Um valor boolean de leitura/gravação. true, se o IIS registrar todas as cadeias de caracteres em UTF-8 (Formato de Transformação UCS 8); caso contrário, false. O padrão é true. Essa configuração aplica todo o servidor a todos os registros em log de modo de texto.
Path (Herdado de ConfigurationSection.) Uma propriedade chave.
SectionInformation (Herdado de ConfigurationSection.)

Subclasses

Essa classe não contém subclasses.

Comentários

Esta classe corresponde à seção <system.applicationHost/log> em ApplicationHost.config.

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

Valor Palavra-chave Descrição
0 Site Todas as solicitações do cliente são registradas no nível do site, e não centralmente no nível do servidor. Os arquivos de log são gerados por site.
1 CentralBinary Todas as solicitações do cliente para todos os sites são registradas em um único arquivo de log no formato binário centralizado no servidor.
2 CentralW3C Todas as solicitações do cliente para todos os sites são registradas em um único arquivo de log no formato centralizado W3C no servidor.

Exemplo

O exemplo de código a seguir exibe o valor da propriedade CentralLogFileMode. Uma função auxiliar converte o valor da enumeração em texto.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the log section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the path and location.  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
  
' Display the central log file mode.  
WScript.Echo "CentralLogFileMode: " & _  
                GetModeText(oSection.CentralLogFileMode)  
  
' ==== GetModeText helper function. ====  
Function GetModeText(intMode)  
    Select Case intMode  
        Case 0  
            GetModeText="Site"  
        Case 1  
            GetModeText="CentralBinary"  
        Case 2  
            GetModeText="CentralW3C"  
        Case Else  
            GetModeText="Undefined value"  
    End Select  
End Function

Hierarquia de herança

ConfigurationSection

LogSection

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 ConfigurationSection
Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe SiteLogFile