EventLogInstaller.Log EventLogInstaller.Log EventLogInstaller.Log EventLogInstaller.Log Property

Definizione

Ottiene o imposta il nome del log sul quale impostare l'origine.Gets or sets the name of the log to set the source to.

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")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
member this.Log : string with get, set
Public Property Log As String

Valore della proprietà

Nome del log.The name of the log. Può trattarsi di un nome di log personalizzato o dei log Applicazione o Sistema.This can be Application, System, or a custom log name. Il valore predefinito è una stringa vuota ("").The default is an empty string ("").

Commenti

È possibile utilizzare la Log proprietà per associare l'origine specificata Source nella proprietà a un log esistente o a un nuovo log nel computer locale.You can use the Log property to associate the source you specify in the Source property with either an existing log or a new log on the local computer. Installutil. exe (utilità di installazione) utilizza queste informazioni per eseguire il mapping dell'origine al log nel registro di sistema del computer.The Installutil.exe (Installer Tool) uses this information to map the source to the log in the computer's registry. Le applicazioni e i servizi devono scrivere nel registro applicazioni o in un log personalizzato.Applications and services should write to the Application log or a custom log. I driver di dispositivo devono scrivere nel registro di sistema.Device drivers should write to the System log.

Per scrivere voci in un log eventi, è necessario creare un'origine e registrarla con un log eventi.To write entries to an event log, you must create a source and register it with an event log. Un'origine evento può scrivere in un solo log alla volta.An event source can only write to one log at a time. Il programma di installazione usa il valore Source della proprietà per registrare l'applicazione con il log eventi come origine valida delle voci.The installer uses the value of the Source property to register your application with the event log as a valid source of entries. Se non si specifica un nome di log prima dell'esecuzione del programma di installazione, il programma di installazione registra l'origine nel registro applicazioni.If you do not specify a log name before the installer runs, the installer registers your source to the Application log. Se si specifica una nuova origine e un log esistente, il programma di installazione crea una nuova origine eventi e la associa al log specificato.If you specify a new source and an existing log, the installer creates a new event source and associates it with the log you specify. 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 fino a quando non viene scritta la prima voce.If you specify both a new source and a new log, the installer associates the new source with the new log in the registry, but the log is not created until the first entry is written to it.

Il sistema operativo archivia i registri eventi come file.The operating system stores event logs as files. Quando si usa EventLogInstaller o il CreateEventSource metodo per creare un nuovo registro eventi, il file associato viene archiviato nella directory%SystemRoot%\System32\Config del computer specificato.When you use EventLogInstaller or the CreateEventSource method to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. Il nome del file viene impostato aggiungendo i primi 8 caratteri della Log proprietà con l'estensione del nome di file ". evt".The file name is set by appending the first 8 characters of the Log property with the ".evt" file name extension.

Utilizzare EventLogInstaller per registrare una nuova origine per un registro eventi nuovo o esistente. non utilizzare EventLogInstaller per modificare un'origine esistente.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. La EventLogInstaller classe non modifica le proprietà di configurazione di un'origine esistente in modo che corrispondano alle proprietà di installazione specificate.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. Il Install metodo genera un'eccezione se la Source proprietà corrisponde a un nome di origine registrato per un registro eventi diverso nel computer.The Install method throws an exception if the Source property matches a source name that is registered for a different event log on the computer. Il Install metodo non registra l'origine se la Source proprietà corrisponde a un nome di origine già registrato per lo stesso registro Log eventi specificato nella proprietà.The Install method does not register the source if the Source property matches a source name that is already registered for the same event log specified in the Log property.

Per informazioni più dettagliate sui comportamenti dei log eventi e delle origini, vedere la EventLog documentazione relativa alla classe per le Source Log proprietà e.For more detailed information about the behaviors of event logs and sources, see the EventLog class documentation for the Log and Source properties.

Si applica a

Vedi anche