Partilhar via


EventLogInstaller.Log Propriedade

Definição

Obtém ou define o nome do log para o qual a origem será definida.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
Public Property Log As String

Valor da propriedade

O nome do log. Isso pode ser Aplicativo, Sistema ou um nome de log personalizado. O padrão é uma cadeia de caracteres vazia ("").

Atributos

Comentários

Você pode usar a Log propriedade para associar a origem especificada na propriedade a Source um log existente ou a um novo log no computador local. O Installutil.exe (Ferramenta instalador) usa essas informações para mapear a origem para o log no registro do computador. Aplicativos e serviços devem gravar no log do aplicativo ou em um log personalizado. Os drivers de dispositivo devem gravar no log do sistema.

Para gravar entradas em um log de eventos, você deve criar uma origem e registrá-la com um log de eventos. Uma fonte de evento só pode gravar em um log por vez. O instalador usa o valor da Source propriedade para registrar seu aplicativo com o log de eventos como uma fonte válida de entradas. Se você não especificar um nome de log antes da execução do instalador, o instalador registrará sua origem no log do aplicativo. Se você especificar uma nova origem e um log existente, o instalador criará uma nova fonte de evento e a associará ao log especificado. Se você especificar uma nova origem e um novo log, o instalador associará a nova fonte ao novo log no Registro, mas o log não será criado até que a primeira entrada seja gravada nele.

O sistema operacional armazena os logs de eventos como arquivos. Quando você usa EventLogInstaller ou o CreateEventSource método para criar um novo log de eventos, o arquivo associado é armazenado no diretório %SystemRoot%\System32\Config no computador especificado. O nome do arquivo é definido acrescentando os primeiros 8 caracteres da Log propriedade com a extensão de nome de arquivo ".evt".

Use EventLogInstaller para registrar uma nova fonte para um log de eventos novo ou existente; não use EventLogInstaller para alterar uma fonte existente. A EventLogInstaller classe não modifica as propriedades de configuração de uma origem existente para corresponder às propriedades de instalação especificadas. O Install método gerará uma exceção se a propriedade corresponder a Source um nome de origem registrado para um log de eventos diferente no computador. O Install método não registrará a origem se a propriedade corresponder a Source um nome de origem já registrado para o mesmo log de eventos especificado na Log propriedade .

Para obter informações mais detalhadas sobre os comportamentos de logs de eventos e fontes, consulte a documentação da EventLog classe para as Log propriedades e Source .

Aplica-se a

Confira também