EventLogInstaller.Source Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o nome de origem para registar no log.
public:
property System::String ^ Source { 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 Source { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.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")]
public string Source { get; set; }[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with 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, setPublic Property Source As StringValor de Propriedade
O nome para registar no registo de eventos como fonte de entradas. O padrão é uma cadeia vazia ("").
- Atributos
Observações
A fonte do evento indica o que regista o evento. É frequentemente o nome da aplicação, ou o nome de um componente dentro de uma grande aplicação.
O instalador usa o valor da Source propriedade para registar a sua aplicação no registo de eventos como fonte válida de entradas. Um novo nome de fonte não pode corresponder a um nome de fonte existente ou a um nome de registo de eventos existente. Cada fonte só pode escrever num registo de eventos de cada vez; No entanto, a sua aplicação pode usar múltiplas fontes para escrever em vários registos de eventos. Por exemplo, a sua aplicação pode exigir múltiplas fontes configuradas para diferentes registos de eventos ou diferentes ficheiros de recursos.
As aplicações e serviços devem escrever no registo de aplicações ou num registo personalizado. Os drivers de dispositivo devem escrever no registo do sistema. Se não especificar um nome de registo antes da execução do instalador, este regista a sua fonte no registo da Aplicação. Se especificar o nome de um registo que não existe, o sistema regista-o Source nesse registo, mas o registo só é criado quando a primeira entrada é escrita nele.
Use EventLogInstaller para registar uma nova fonte para um registo 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 fonte existente para corresponder às propriedades de instalação especificadas. O Install método lança uma exceção se a Source propriedade corresponder a um nome de origem registado para um registo de eventos diferente no computador. O Install método não regista a fonte se a Source propriedade coincidir com um nome de origem já registado para o mesmo registo de eventos especificado na Log propriedade.
Para informações mais detalhadas sobre os comportamentos dos registos de eventos e fontes, consulte a EventLog documentação da classe para as Log propriedades e Source .
