EventLog.Log Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacchetto:

System.Diagnostics.EventLog v8.0.0

Origine:

EventLog.cs

Ottiene o imposta il nome del log da cui leggere o in cui 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 log. Può trattarsi di un nome di log personalizzato o dei log Applicazione, Sistema o Sicurezza. Il valore predefinito è una stringa vuota ("").

Attributi

SettingsBindableAttribute

Esempio

L'esempio seguente legge le voci nel registro eventi "NewEventLog" nel computer locale.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   System::Collections::IEnumerator^ myEnum = myNewLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

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. Applicazioni e servizi usano il file di log dell'applicazione. 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 viene attivato il controllo. 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 log dell'applicazione predefinito.

Nota

I nomi di 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 Source oggetto 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.

Nota

Non è necessario specificare se MachineName si esegue la connessione a un log. Se non si specifica , MachineNamesi presuppone che 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 è stato specificato, Log restituisce il nome del log a cui è stata registrata l'origineSource.

Un'origine può essere registrata solo in un log alla volta. Se la proprietà è stata impostata per un'istanza Source di EventLog, non è possibile modificare la proprietà per tale EventLog proprietà senza modificare il Log valore di Source o chiamare DeleteEventSource prima. Se si modifica la proprietà dopo che la LogSource proprietà è stata impostata, la 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 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 creare (e scrivere voci) nuovi log specifici dell'applicazione o leggere dai log esistenti.

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

Attenzione

Se si imposta la Log proprietà sul nome di un log che non esiste, il sistema collega al EventLog log dell'applicazione, ma non avvisa che usa un log diverso da quello specificato.

Vedi anche

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