EventLogTraceListener Classe
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.
Fournit un écouteur simple qui dirige le suivi ou le débogage de la sortie vers un EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Héritage
Exemples
L’exemple suivant crée un écouteur de suivi qui envoie la sortie à un journal des événements. Tout d’abord, le code crée un nouveau EventLogTraceListener qui utilise la source myEventLogSource. Ensuite, myTraceListener est ajouté à la Trace.Listeners collection. Enfin, l’exemple envoie une ligne de sortie à l’objet Listeners .
// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);
// Write output to the event log.
Trace.WriteLine("Test output");
Overloads Public Shared Sub Main(args() As String)
' Create a trace listener for the event log.
Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
' Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener)
' Write output to the event log.
Trace.WriteLine("Test output")
End Sub
Remarques
Une instance de ce paramètre EventLogTraceListener peut être ajoutée au Debug.Listenersou Trace.ListenersTraceSource.Listeners aux regroupements pour envoyer la sortie du suivi ou du débogage à un EventLog. Vous pouvez ajouter l’instance dans votre code ou, pour une application .NET Framework, la spécifier dans le fichier de configuration de l’application.
Pour ajouter un fichier de configuration d’application EventLogTraceListener .NET Framework, modifiez le fichier correspondant au nom de votre application. Dans ce fichier, insérez un élément pour un System.Diagnostics.EventLogTraceListener type. L’exemple suivant ajoute un EventLogTraceListener objet nommé myListener à la Trace.Listeners collection. Le initializeData paramètre spécifie le nom de la source du journal des événements à passer au EventLogTraceListener(String) constructeur.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Note
Si le Source journal des événements associé à l’instance EventLogTraceListener n’existe pas, une nouvelle source d’événement est créée. Pour créer une source d’événement dans Windows Vista, Windows XP Professionnel ou Windows Server 2003, vous devez disposer de privilèges d’administration.
La raison de cette exigence est que tous les journaux d’événements, y compris la sécurité, doivent être recherchés pour déterminer si la source d’événement est unique. Dans Windows Vista, les utilisateurs n’ont pas l’autorisation d’accéder au journal de sécurité ; par conséquent, une SecurityException est levée.
Dans Windows Vista, le contrôle de compte d’utilisateur (UAC) détermine les privilèges d’un utilisateur. Si vous êtes membre du groupe Administrateurs intégrés, vous disposez de deux jetons d’accès au moment de l’exécution : un jeton d’accès utilisateur standard et un jeton d’accès administrateur. Par défaut, vous êtes dans le rôle d’utilisateur standard. Pour exécuter le code qui accède au journal de sécurité, vous devez d’abord élever vos privilèges de l’utilisateur standard à l’administrateur. Pour ce faire, lorsque vous démarrez une application, cliquez avec le bouton droit sur l’icône de l’application et indiquez que vous souhaitez exécuter en tant qu’administrateur.
La classe fournit la EventLog propriété pour obtenir ou définir le journal des événements qui reçoit la sortie de suivi ou de débogage, et la Name propriété pour contenir le nom du EventLogTraceListenerfichier .
La Close méthode ferme le journal des événements afin qu’elle ne reçoive plus de suivi ou de sortie de débogage. Les Write méthodes et WriteLine écrivent un message dans le journal des événements.
Note
Pour éviter la possibilité d’écrire de grandes quantités de données dans le journal des événements, elle EventLogTraceListener ne génère pas les données de trace facultatives spécifiées par la TraceOutputOptions propriété.
Constructeurs
| Nom | Description |
|---|---|
| EventLogTraceListener() |
Initialise une nouvelle instance de la EventLogTraceListener classe sans écouteur de trace. |
| EventLogTraceListener(EventLog) |
Initialise une nouvelle instance de la classe à l’aide EventLogTraceListener du journal des événements spécifié. |
| EventLogTraceListener(String) |
Initialise une nouvelle instance de la classe à l’aide EventLogTraceListener de la source spécifiée. |
Propriétés
| Nom | Description |
|---|---|
| Attributes |
Obtient les attributs d’écouteur de trace personnalisés définis dans le fichier de configuration de l’application. (Hérité de TraceListener) |
| EventLog |
Obtient ou définit le journal des événements dans lequel écrire. |
| Filter |
Obtient ou définit le filtre de trace pour l’écouteur de trace. (Hérité de TraceListener) |
| IndentLevel |
Obtient ou définit le niveau de retrait. (Hérité de TraceListener) |
| IndentSize |
Obtient ou définit le nombre d’espaces dans un retrait. (Hérité de TraceListener) |
| IsThreadSafe |
Obtient une valeur indiquant si l’écouteur de trace est thread-safe. (Hérité de TraceListener) |
| Name |
Obtient ou définit le nom de ce EventLogTraceListener. |
| NeedIndent |
Obtient ou définit une valeur indiquant s’il faut mettre en retrait la sortie. (Hérité de TraceListener) |
| TraceOutputOptions |
Obtient ou définit les options de sortie de trace. (Hérité de TraceListener) |
Méthodes
| Nom | Description |
|---|---|
| Close() |
Ferme le journal des événements afin qu’il ne reçoive plus de suivi ou de sortie de débogage. |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par le TraceListener. (Hérité de TraceListener) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les TraceListener ressources gérées et libère éventuellement les ressources managées. (Hérité de TraceListener) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| Fail(String, String) |
Émet un message d’erreur et un message d’erreur détaillé à l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Fail(String) |
Émet un message d’erreur à l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Flush() |
En cas de substitution dans une classe dérivée, vide la mémoire tampon de sortie. (Hérité de TraceListener) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetLifetimeService() |
Obsolète.
Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtient les attributs personnalisés pris en charge par l’écouteur de trace. (Hérité de TraceListener) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| InitializeLifetimeService() |
Obsolète.
Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Écrit des informations de trace, un objet de données et des informations d’événement dans le journal des événements. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Écrit des informations de trace, un tableau d’objets de données et des informations d’événement dans le journal des événements. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Écrit des informations de trace, un tableau d’objets mis en forme et des informations d’événement dans le journal des événements. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Écrit des informations de trace, un message et des informations d’événement dans le journal des événements. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Écrit les informations de trace et d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Écrit des informations de trace, un message, une identité d’activité associée et des informations d’événement dans la sortie spécifique de l’écouteur. (Hérité de TraceListener) |
| Write(Object, String) |
Écrit un nom de catégorie et la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(Object) |
Écrit la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(String, String) |
Écrit un nom de catégorie et un message dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe. (Hérité de TraceListener) |
| Write(String) |
Écrit un message dans le journal des événements de cette instance. |
| WriteIndent() |
Écrit le retrait dans l’écouteur que vous créez lorsque vous implémentez cette classe et réinitialise la NeedIndent propriété sur |
| WriteLine(Object, String) |
Écrit un nom de catégorie et la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivie d’un terminateur de ligne. (Hérité de TraceListener) |
| WriteLine(Object) |
Écrit la valeur de la méthode de ToString() l’objet dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivie d’une marque de fin de ligne. (Hérité de TraceListener) |
| WriteLine(String, String) |
Écrit un nom de catégorie et un message dans l’écouteur que vous créez lorsque vous implémentez la TraceListener classe, suivi d’un terminateur de ligne. (Hérité de TraceListener) |
| WriteLine(String) |
Écrit un message dans le journal des événements de cette instance. |
S’applique à
Cohérence de thread
Ce type est thread safe.
