EventLogInstaller.Log Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Ottiene o imposta il nome del log sul quale impostare l'origine.

public:
 property System::String ^ Log { 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 Log { 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

Valore della proprietà

String

Nome del log. Può trattarsi di un nome di log personalizzato o dei log Applicazione o Sistema. Il valore predefinito è una stringa vuota ("").

Attributi

TypeConverterAttribute

Commenti

È possibile usare la Log proprietà per associare l'origine Source specificata nella proprietà a un log esistente o a un nuovo log nel computer locale. Il Installutil.exe (Strumento di installazione) usa queste informazioni per eseguire il mapping dell'origine al registro del computer. Le applicazioni e i servizi devono scrivere nel log dell'applicazione o in un log personalizzato. I driver di dispositivo devono scrivere nel log di sistema.

Per scrivere voci in un registro eventi, è necessario creare un'origine e registrarla con un registro eventi. Un'origine evento può scrivere solo in un log alla volta. Il programma di installazione usa il valore della proprietà per registrare l'applicazione Source con il registro eventi come origine valida delle voci. Se non si specifica un nome di log prima dell'esecuzione del programma di installazione, il programma di installazione registra l'origine nel log dell'applicazione. Se si specifica una nuova origine e un log esistente, il programma di installazione crea una nuova origine evento e la associa al log specificato. Se si specifica sia una nuova origine che un nuovo log, il programma di installazione associa la nuova origine al nuovo log nel Registro di sistema, ma il log non viene creato finché non viene scritta la prima voce.

Il sistema operativo archivia i registri eventi come file. Quando si usa EventLogInstaller o il CreateEventSource metodo per creare un nuovo registro eventi, il file associato viene archiviato nella directory %SystemRoot%\System32\Config nel computer specificato. Il nome del file viene impostato aggiungendo i primi 8 caratteri della Log proprietà con l'estensione del nome file ".evt".

Usare EventLogInstaller per registrare una nuova origine per un registro eventi nuovo o esistente. Non usare EventLogInstaller per modificare un'origine esistente. La EventLogInstaller classe non modifica le proprietà di configurazione di un'origine esistente in modo che corrispondano alle proprietà di installazione specificate. Il Install metodo genera un'eccezione se la Source proprietà corrisponde a un nome di origine registrato per un registro eventi diverso nel computer. Il Install metodo non registra l'origine se la Source proprietà corrisponde a un nome di origine già registrato per lo stesso registro eventi specificato nella Log proprietà.

Per informazioni più dettagliate sui comportamenti dei log eventi e delle origini, vedere la EventLog documentazione della classe per le Log proprietà e Source .

Vedi anche

• Log
• EventLog