EventLog.Log EventLog.Log EventLog.Log EventLog.Log Property

Definizione

Ottiene o imposta il nome del log da cui leggere o in cui scrivere.Gets or sets the name of the log to read from or write to.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.SettingsBindable(true)]
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, Sistema o Sicurezza.This can be Application, System, Security, or a custom log name. Il valore predefinito è una stringa vuota ("").The default is an empty string ("").

Esempi

Nell'esempio seguente legge le voci nel registro eventi, "NewEventLog", nel computer locale.The following example reads entries in the event log, "NewEventLog", on the local computer.

#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
Imports System.Diagnostics
Imports Microsoft.VisualBasic

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 'Main
End Class 'MySample

Commenti

Per impostazione predefinita nel server sono presenti tre file di log: Applicazione, sistema e sicurezza.Three log files exist by default on the server: Application, System, and Security. Servizi e applicazioni di utilizzano il file di log dell'applicazione.Applications and services use the Application log file. I driver di dispositivo usano il file di registro di sistema.Device drivers use the System log file. Il sistema genera gli eventi di controllo e non riuscite nel log di sicurezza quando il controllo è attivato.The system generates success and failure audit events in the Security log when auditing is turned on. Se si dispone di altre applicazioni installate, come Active Directory nei server Windows, potrebbero esserci altri file di log predefinito.If you have other applications installed, like Active Directory on Windows servers, there might be other default log files. Inoltre, è possibile creare file di log personalizzati in un computer locale o remoto.In addition, you can create custom log files on a local or remote computer. I log personalizzati consentono di organizzare i dati immessi in modo più dettagliato rispetto alla scrittura di eventi nel registro dell'applicazione predefinito dei componenti.Custom logs help organize your entries in a more detailed way than is allowed when your components write events to the default Application log.

Nota

I nomi dei log sono limitate a otto caratteri.Log names are limited to eight characters. In base al sistema, MyLogSample1 e MyLogSample2 rappresentano lo stesso log.According to the system, MyLogSample1 and MyLogSample2 are the same log.

Se si scrive in un log eventi, non è sufficiente specificare il Log proprietà.If you write to an event log, it is not enough to specify the Log property. È necessario associare un Source proprietà alla risorsa del registro eventi per connetterla a un registro specifico.You must associate a Source property with your event log resource to connect it to a particular log. Non è necessario specificare un Source quando leggere solo da un log, ma un'origine evento deve essere associata alla risorsa di log eventi nel Registro di sistema del server.It is not necessary to specify a Source when only reading from a log, but an event source must be associated with the event log resource in the server's registry. È possibile specificare solo il Log name e MachineName (nome del computer server) per leggere da essa.You can specify only the Log name and MachineName (server computer name) to read from it.

Nota

Non è necessario specificare il MachineName se ci si connette a un log.You are not required to specify the MachineName if you are connecting to a log. Se non si specifica il MachineName, il computer locale (".") verrà utilizzato.If you do not specify the MachineName, the local computer (".") is assumed.

Se il Source proprietà non è stata specificata, una chiamata a Log restituisce una stringa vuota se Log non è stato impostato in modo esplicito (impostando il Log proprietà o tramite il costruttore).If the Source property has not been specified, a call to Log returns an empty string if Log has not been explicitly set (by setting the Log property, or through the constructor). Se il Source è stata specificata, Log restituisce il nome del log in cui è stata registrata tale origine.If the Source has been specified, Log returns the name of the log to which that source was registered.

Un'origine può essere registrata solo in un log alla volta.A source can only be registered to one log at a time. Se il Source proprietà è stata impostata per un'istanza di EventLog, non è possibile modificare le Log proprietà per tale EventLog senza modificare il valore di Source o la chiamata DeleteEventSource prima.If the Source property was set for an instance of EventLog, you cannot change the Log property for that EventLog without changing the value of Source or calling DeleteEventSource first. Se si modifica il Log proprietà dopo il Source proprietà è stata impostata, la scrittura di una voce di log genera un'eccezione.If you change the Log property after the Source property has been set, writing a log entry throws an exception.

Il sistema operativo archivia i registri eventi come file.The operating system stores event logs as files. 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.When you use EventLogInstaller or CreateEventSource 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 è impostato aggiungendo i primi 8 caratteri del Log proprietà con l'estensione "estensione evt".The file name is set by appending the first 8 characters of the Log property with the ".evt" file name extension.

Non è possibile creare un nuovo log usando il Log proprietà autonomo (senza specificare un'origine per il log).You cannot create a new log using the Log property alone (without specifying a source for the log). È possibile chiamare CreateEventSource, passando un nuovo nome di log come parametro e quindi chiamare DeleteEventSource.You can call CreateEventSource, passing in a new log name as a parameter, and then call DeleteEventSource. Tuttavia, lo scopo è in genere per creare (e la scrittura di voci per) nuovi log specifici dell'applicazione, o da cui leggere i log esistenti.However, the intent is usually either to create (and write entries to) new application-specific logs, or to read from existing logs.

Se il Log le modifiche dei valori, il registro eventi viene chiusa e vengono rilasciati tutti gli handle di evento.If the Log value changes, the event log is closed and all event handles are released.

Attenzione

Se si imposta la Log proprietà sul nome di un log che non esiste, il sistema associa il EventLog nel registro applicazioni, ma non avvisa l'utente che viene usato un log diverso da quello specificato.If you set the Log property to the name of a log that does not exist, the system attaches the EventLog to the Application log, but does not warn you that it is using a log other than the one you specified.

Sicurezza

EventLogPermission
per la scrittura di informazioni del log eventi nel computer.for writing the event log information on the computer. Enumerazione associata: WriteAssociated enumeration: Write

Si applica a

Vedi anche