EventLog.Source Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Source:

EventLog.cs

Obtient ou définit le nom de la source à inscrire et à utiliser lors de l’écriture dans le journal des événements.

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

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

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

Public Property Source As String

Valeur de propriété

String

Nom inscrit dans le journal des événements en tant que source d’entrées. La valeur par défaut est une chaîne vide ( » « ).

Attributs

SettingsBindableAttribute

Exceptions

ArgumentException

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

Exemples

L’exemple suivant crée la source MySource s’il n’existe pas déjà et écrit une entrée dans le journal MyNewLogdes événements.

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");

        Console.WriteLine("Message written to event log.");
    }
}

Option Explicit
Option Strict
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
        
        Console.WriteLine("Message written to event log.")
    End Sub
End Class

Remarques

La source d’événement indique les journaux de l’événement. Il s’agit souvent du nom de l’application ou du nom d’un sous-composant de l’application, si l’application est volumineuse. Les applications et services doivent écrire dans le journal des applications ou dans un journal personnalisé. Les pilotes de périphérique doivent écrire dans le journal système.

Vous devez uniquement spécifier une source d’événement si vous écrivez dans un journal des événements. Avant d’écrire une entrée dans un journal des événements, vous devez inscrire la source d’événement auprès du journal des événements comme source valide d’événements. Lorsque vous écrivez une entrée de journal, le système utilise la Source propriété pour trouver le journal approprié dans lequel placer votre entrée. Si vous lisez le journal des événements, vous pouvez spécifier le Source, ou a Log et MachineName.

Note

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

Utilisez et WriteEntry écrivez WriteEvent des événements dans un journal des événements. Vous devez spécifier une source d’événement pour écrire des événements ; vous devez créer et configurer la source d’événement avant d’écrire la première entrée avec la source.

Créez la source d’événement pendant l’installation de votre application. Cela permet au système d’exploitation d’actualiser sa liste de sources d’événements inscrites et de leur configuration. Si le système d’exploitation n’a pas actualisé sa liste de sources d’événements et que vous tentez d’écrire un événement avec la nouvelle source, l’opération d’écriture échoue. Vous pouvez configurer une nouvelle source à l’aide d’une EventLogInstallerou de la CreateEventSource méthode. Vous devez disposer de droits d’administration sur l’ordinateur pour créer une source d’événement.

Vous pouvez créer une source d’événement pour un journal des événements existant ou un nouveau journal des événements. Lorsque vous créez une source pour un nouveau journal des événements, le système inscrit la source de ce journal, mais le journal n’est pas créé tant que la première entrée n’est pas écrite.

La source doit être unique sur l’ordinateur local ; Un nouveau nom source ne peut pas correspondre à un nom source existant ou à un nom de journal des événements existant. Chaque source peut écrire dans un seul journal des événements à la fois ; Toutefois, votre application peut utiliser plusieurs sources pour écrire dans plusieurs journaux d’événements. Par exemple, votre application peut nécessiter plusieurs sources configurées pour différents journaux d’événements ou différents fichiers de ressources.

Si vous modifiez la Source valeur, la EventLog valeur à laquelle elle est inscrite est fermée et tous les handles d’événements sont libérés.

La source doit être configurée pour écrire des entrées localisées ou pour écrire des chaînes directes. Si votre application écrit des entrées à l’aide des identificateurs de ressource et des valeurs de chaîne, vous devez inscrire deux sources distinctes. Par exemple, configurez une source avec des fichiers de ressources, puis utilisez cette source dans la WriteEvent méthode pour écrire des entrées à l’aide d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources et utilisez cette source dans la WriteEntry méthode pour écrire des chaînes directement dans le journal des événements à l’aide de cette source.

Pour modifier les détails de configuration d’une source existante, vous devez supprimer la source, puis la créer avec la nouvelle configuration. Si d’autres applications ou composants utilisent la source existante, créez une nouvelle source avec la configuration mise à jour plutôt que de supprimer la source existante.

Note

Si une source a déjà été mappée à un journal et que vous la remappagez sur un nouveau journal, vous devez redémarrer l’ordinateur pour que les modifications prennent effet.

Voir aussi

• Log
• MachineName
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)