EventLogInstaller.Source Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Obtém ou define o nome da origem a ser registrada com o log.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set

Public Property Source As String

Valor da propriedade

String

O nome a ser registrado com o log de eventos como uma fonte de entradas. O padrão é uma cadeia de caracteres vazia ("").

Atributos

TypeConverterAttribute

Comentários

A origem do evento indica o que registra o evento. Geralmente, é o nome do aplicativo ou o nome de um componente em um aplicativo grande.

O instalador usa o valor da Source propriedade para registrar seu aplicativo no log de eventos como uma fonte válida de entradas. Um novo nome de origem não pode corresponder a um nome de origem existente ou a um nome de log de eventos existente. Cada fonte só pode gravar em um log de eventos por vez; no entanto, seu aplicativo pode usar várias fontes para gravar em vários logs de eventos. Por exemplo, seu aplicativo pode exigir várias fontes configuradas para logs de eventos diferentes ou arquivos de recursos diferentes.

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. 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 o nome de um log que não existe, o sistema registrará o Source nesse log, mas o log não será criado até que a primeira entrada seja gravada nele.

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 que já esteja 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 .

Confira também

• Source
• EventLog