EventLog.Log Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Source:

EventLog.cs

Obtient ou définit le nom du journal à lire ou à écrire.

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, de système, de 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 dans le journal des événements, « NewEventLog », sur l’ordinateur local.

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 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 les 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 de manière plus détaillée que ce qui est autorisé lorsque vos composants écrivent des événements dans le journal d’application par défaut.

Note

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

Si vous écrivez dans un journal des événements, il n’est pas suffisant 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 une Source seule lecture à 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.

Note

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

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

Une source ne peut être inscrite qu’à un seul journal à la fois. Si la Source propriété a été définie pour une instance de EventLog, vous ne pouvez pas modifier la Log propriété pour celle-ci EventLog sans modifier la valeur ou Source appeler DeleteEventSource en premier. 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 d’événements sous forme de fichiers. Lorsque vous utilisez EventLogInstaller ou CreateEventSource créez 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 de source pour le journal). Vous pouvez appeler CreateEventSource, passer un nouveau nom de journal en tant que paramètre, puis appeler DeleteEventSource. Toutefois, l’intention est généralement de créer (et d’écrire des entrées dans) de nouveaux journaux spécifiques à l’application ou de lire des journaux existants.

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

Avertissement

Si vous définissez la Log propriété sur le nom d’un journal qui n’existe pas, le système attache le EventLog journal d’application, 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