EventLogInstaller.Log Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Obtient ou définit le nom du journal pour lequel définir la source.

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

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
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 ou d'un nom de journal personnalisé. La valeur par défaut est une chaîne vide ("").

Attributs

TypeConverterAttribute

Remarques

Vous pouvez utiliser la Log propriété pour associer la source que vous spécifiez dans la Source propriété à un journal existant ou à un nouveau journal sur l’ordinateur local. Le Installutil.exe (outil d’installation) utilise ces informations pour mapper la source au journal dans le registre de l’ordinateur. Les applications et les 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.

Pour écrire des entrées dans un journal des événements, vous devez créer une source et l’inscrire auprès d’un journal des événements. Une source d’événement ne peut écrire que dans un journal à la fois. Le programme d’installation utilise la valeur de la Source propriété pour inscrire votre application auprès du journal des événements en tant que source valide d’entrées. Si vous ne spécifiez pas de nom de journal avant l’exécution du programme d’installation, le programme d’installation inscrit votre source dans le journal des applications. Si vous spécifiez une nouvelle source et un journal existant, le programme d’installation crée une source d’événements et l’associe au journal que vous spécifiez. Si vous spécifiez à la fois une nouvelle source et un nouveau journal, le programme d’installation associe la nouvelle source au nouveau journal dans le Registre, mais le journal n’est pas créé tant que la première entrée n’y est pas écrite.

Le système d’exploitation stocke les journaux des événements sous forme de fichiers. Lorsque vous utilisez EventLogInstaller ou la CreateEventSource méthode 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.

Utilisez EventLogInstaller pour inscrire une nouvelle source pour un journal des événements nouveau ou existant ; n’utilisez EventLogInstaller pas pour modifier une source existante. La EventLogInstaller classe ne modifie pas les propriétés de configuration d’une source existante pour qu’elles correspondent aux propriétés d’installation spécifiées. La Install méthode lève une exception si la Source propriété correspond à un nom de source inscrit pour un autre journal des événements sur l’ordinateur. La Install méthode n’inscrit pas la source si la Source propriété correspond à un nom de source déjà inscrit pour le journal des événements spécifié dans la Log propriété .

Pour plus d’informations sur les comportements des journaux d’événements et des sources, consultez la documentation de classe EventLog pour les Log propriétés et Source .

Voir aussi

• Log
• EventLog