EventLog.Log Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Source:

EventLog.cs

Obtient ou définit le nom du journal à utiliser en lecture ou en écriture.

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

Valeur de propriété

String

Nom du journal. Il peut s'agir d'application, système, sécurité ou d'un nom de journal personnalisé. La valeur par défaut est une chaîne vide ("").

Attributs

SettingsBindableAttribute

Exemples

L’exemple suivant lit les entrées du journal des événements, « NewEventLog », sur l’ordinateur local.

#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

Remarques

Trois fichiers journaux existent par défaut sur le serveur : Application, Système et Sécurité. Les applications et les services utilisent le fichier journal des applications. Les pilotes de périphérique utilisent le fichier journal système. Le système génère des événements d’audit de réussite et d’échec dans le journal de sécurité lorsque l’audit est activé. Si d’autres applications sont installées, comme Active Directory sur des serveurs Windows, il peut y avoir d’autres fichiers journaux par défaut. En outre, vous pouvez créer des fichiers journaux personnalisés sur un ordinateur local ou distant. Les journaux personnalisés permettent d’organiser vos entrées d’une manière plus détaillée que ce qui est autorisé lorsque vos composants écrivent des événements dans le journal des applications par défaut.

Notes

Les noms de journal sont limités à huit caractères. Selon le système, MyLogSample1 et MyLogSample2 sont le même journal.

Si vous écrivez dans un journal des événements, il ne suffit pas de spécifier la Log propriété . Vous devez associer une Source propriété à votre ressource de journal des événements pour la connecter à un journal particulier. Il n’est pas nécessaire de spécifier un Source lors de la lecture uniquement à partir d’un journal, mais une source d’événement doit être associée à la ressource du journal des événements dans le registre du serveur. Vous pouvez spécifier uniquement le Log nom et MachineName (nom de l’ordinateur serveur) à lire à partir de celui-ci.

Notes

Vous n’êtes pas obligé de spécifier si MachineName vous vous connectez à un journal. Si vous ne spécifiez pas , MachineNamel’ordinateur local (« . ») est supposé.

Si la Source propriété n’a pas été spécifiée, un appel à Log retourne une chaîne vide si Log n’a pas été défini explicitement (en définissant la Log propriété ou via le constructeur). Si a Source été spécifié, Log retourne le nom du journal dans lequel cette source a été inscrite.

Une source ne peut être inscrite que dans un journal à la fois. Si la Source propriété a été définie pour un instance de EventLog, vous ne pouvez pas modifier la Log propriété pour cela EventLog sans modifier la valeur de ou appeler DeleteEventSource d’abordSource. Si vous modifiez la Log propriété une fois la Source propriété définie, l’écriture d’une entrée de journal lève une exception.

Le système d’exploitation stocke les journaux des événements sous forme de fichiers. Lorsque vous utilisez EventLogInstaller ou CreateEventSource pour créer un journal des événements, le fichier associé est stocké dans le répertoire %SystemRoot%\System32\Config sur l’ordinateur spécifié. Le nom de fichier est défini en ajoutant les 8 premiers caractères de la Log propriété avec l’extension de nom de fichier .evt.

Vous ne pouvez pas créer un journal à l’aide de la Log propriété seule (sans spécifier une source pour le journal). Vous pouvez appeler CreateEventSource, en passant un nouveau nom de journal en tant que paramètre, puis appeler DeleteEventSource. Toutefois, l’objectif est généralement de créer (et d’écrire des entrées dans) de nouveaux journaux spécifiques à l’application, ou de lire à partir de journaux existants.

Si la Log valeur change, le journal des événements est fermé et tous les descripteurs d’événements sont libérés.

Attention

Si vous définissez la Log propriété sur le nom d’un journal qui n’existe pas, le système attache le EventLog au journal des applications, mais ne vous avertit pas qu’il utilise un journal autre que celui que vous avez spécifié.

Voir aussi

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