EventLogInstaller.Source Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le nom de source à enregistrer auprès du journal.
public:
property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, setPublic Property Source As StringValeur de propriété
Nom à enregistrer auprès du journal des événements comme source d'entrées. La valeur par défaut est une chaîne vide ("").
- Attributs
Remarques
La source de l’événement indique ce qui journalise l’événement. Il s’agit souvent du nom de l’application, ou du nom d’un composant au sein d’une grande application.
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. Un nouveau nom de source ne peut pas correspondre à un nom de source existant ou à un nom de journal des événements existant. Chaque source ne peut écrire que dans un 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.
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. 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 le nom d’un journal qui n’existe pas, le système inscrit dans Source ce journal, mais le journal n’est créé que lorsque la première entrée y est écrite.
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 .
