EventLog.Log Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Origine:

EventLog.cs

Ottiene o imposta il nome del log in cui leggere o scrivere.

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

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

Public Property Log As String

Valore della proprietà

String

Nome del registro. Può trattarsi di application, system, security o un nome di log personalizzato. Il valore predefinito è una stringa vuota ("").

Attributi

SettingsBindableAttribute

Esempio

Nell'esempio seguente vengono lette le voci nel registro eventi "NewEventLog" nel computer locale.

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

Commenti

Tre file di log esistono per impostazione predefinita nel server: Applicazione, Sistema e Sicurezza. Le applicazioni e i servizi usano il file di log applicazioni. I driver di dispositivo usano il file di log di sistema. Il sistema genera eventi di controllo di esito positivo e negativo nel log di sicurezza quando il controllo è attivato. Se sono installate altre applicazioni, ad esempio Active Directory nei server Windows, potrebbero essere presenti altri file di log predefiniti. Inoltre, è possibile creare file di log personalizzati in un computer locale o remoto. I log personalizzati consentono di organizzare le voci in modo più dettagliato di quanto sia consentito quando i componenti scrivono eventi nel registro applicazioni predefinito.

Annotazioni

I nomi dei log sono limitati a otto caratteri. In base al sistema, MyLogSample1 e MyLogSample2 sono lo stesso log.

Se si scrive in un registro eventi, non è sufficiente specificare la Log proprietà . È necessario associare una Source proprietà alla risorsa del registro eventi per connetterla a un determinato log. Non è necessario specificare un oggetto Source quando si legge solo da un log, ma un'origine evento deve essere associata alla risorsa del registro eventi nel Registro di sistema del server. È possibile specificare solo il Log nome e MachineName (nome computer server) da leggere.

Annotazioni

Non è necessario specificare se MachineName ci si connette a un log. Se non si specifica MachineName, viene utilizzato il computer locale (".").

Se la Source proprietà non è stata specificata, una chiamata a Log restituisce una stringa vuota se Log non è stata impostata in modo esplicito (impostando la Log proprietà o tramite il costruttore). Se è Source stato specificato , Log restituisce il nome del log a cui è stata registrata l'origine.

Un'origine può essere registrata solo in un log alla volta. Se la Source proprietà è stata impostata per un'istanza di EventLog, non è possibile modificare la Log proprietà per tale EventLog proprietà senza modificare il valore di Source o chiamare DeleteEventSource prima di tutto. Se si modifica la Log proprietà dopo che la proprietà è stata impostata, la Source scrittura di una voce di log genera un'eccezione.

Il sistema operativo archivia i registri eventi come file. Quando si usa EventLogInstaller o CreateEventSource 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 di file ".evt".

Non è possibile creare un nuovo log usando solo la Log proprietà (senza specificare un'origine per il log). È possibile chiamare CreateEventSource, passando un nuovo nome di log come parametro e quindi chiamare DeleteEventSource. Tuttavia, la finalità è in genere quella di creare (e scrivere voci in) nuovi log specifici dell'applicazione o di leggere da log esistenti.

Se il Log valore viene modificato, il registro eventi viene chiuso e tutti gli handle di evento vengono rilasciati.

Attenzione

Se si imposta la Log proprietà sul nome di un log che non esiste, il sistema collega l'oggetto EventLog al registro applicazioni, ma non avvisa che sta usando un log diverso da quello specificato.

Vedi anche

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection