EventSource Constructeurs
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.
Crée une instance de la EventSource classe.
Surcharges
| Nom | Description |
|---|---|
| EventSource() |
Crée une instance de la EventSource classe. |
| EventSource(Boolean) |
Crée une instance de la classe EventSource et spécifie s’il faut lever une exception lorsqu’une erreur se produit dans le code Windows sous-jacent. |
| EventSource(EventSourceSettings) |
Crée une instance de la EventSource classe avec les paramètres de configuration spécifiés. |
| EventSource(String) |
Crée une instance de la EventSource classe avec le nom spécifié. |
| EventSource(EventSourceSettings, String[]) |
Initialise une nouvelle instance de l’instance EventSource à utiliser avec des événements non contractuels qui contiennent les paramètres et caractéristiques spécifiés. |
| EventSource(String, EventSourceSettings) |
Crée une instance de la EventSource classe avec le nom et les paramètres spécifiés. |
| EventSource(String, EventSourceSettings, String[]) |
Crée une instance de la EventSource classe avec les paramètres de configuration spécifiés. |
EventSource()
Crée une instance de la EventSource classe.
protected:
EventSource();protected EventSource();Protected Sub New ()S’applique à
EventSource(Boolean)
Crée une instance de la classe EventSource et spécifie s’il faut lever une exception lorsqu’une erreur se produit dans le code Windows sous-jacent.
protected:
EventSource(bool throwOnEventWriteErrors);protected EventSource(bool throwOnEventWriteErrors);new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSourceProtected Sub New (throwOnEventWriteErrors As Boolean)Paramètres
- throwOnEventWriteErrors
- Boolean
true pour lever une exception lorsqu’une erreur se produit dans le code Windows sous-jacent ; sinon, false.
S’applique à
EventSource(EventSourceSettings)
Crée une instance de la EventSource classe avec les paramètres de configuration spécifiés.
protected:
EventSource(System::Diagnostics::Tracing::EventSourceSettings settings);protected EventSource(System.Diagnostics.Tracing.EventSourceSettings settings);new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSourceProtected Sub New (settings As EventSourceSettings)Paramètres
- settings
- EventSourceSettings
Combinaison de bits des valeurs d’énumération qui spécifient les paramètres de configuration à appliquer à la source d’événement.
Remarques
La spécification settings du moment où l’objet EventSource est construit vous permet de spécifier si l’événement est écrit dans un manifeste ou dans un format auto-décrivant. En outre, vous pouvez spécifier qu’une exception doit être levée lorsqu’une erreur se produit pendant le processus d’écriture d’événements.
S’applique à
EventSource(String)
Crée une instance de la EventSource classe avec le nom spécifié.
public:
EventSource(System::String ^ eventSourceName);public EventSource(string eventSourceName);new System.Diagnostics.Tracing.EventSource : string -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String)Paramètres
- eventSourceName
- String
Nom à appliquer à la source d’événement. Ne doit pas être null.
Exceptions
eventSourceName a la valeur null.
Remarques
Lorsque vous utilisez ce constructeur, vérifiez que l’argument eventSourceName correspond au nom ETW défini par l’attribut EventSourceAttribute sur ce type. Sinon, les GUID retournés par la Guid propriété et la GetGuid(Type) méthode seront différents. Si les noms de source d’événement diffèrent, la Guid propriété retourne le GUID utilisé pour inscrire cet EventSource auprès d’ETW.
S’applique à
EventSource(EventSourceSettings, String[])
Initialise une nouvelle instance de l’instance EventSource à utiliser avec des événements non contractuels qui contiennent les paramètres et caractéristiques spécifiés.
protected:
EventSource(System::Diagnostics::Tracing::EventSourceSettings settings, ... cli::array <System::String ^> ^ traits);protected EventSource(System.Diagnostics.Tracing.EventSourceSettings settings, params string[] traits);new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSourceProtected Sub New (settings As EventSourceSettings, ParamArray traits As String())Paramètres
- settings
- EventSourceSettings
Combinaison de bits des valeurs d’énumération qui spécifient les paramètres de configuration à appliquer à la source d’événement.
- traits
- String[]
Paires clé-valeur qui spécifient des caractéristiques pour la source d’événement.
Exceptions
traits n’est pas spécifié dans les paires clé-valeur.
Remarques
Les caractéristiques fournissent des informations supplémentaires pour un événement et sont interprétées par un écouteur d’événement. Les caractéristiques sont spécifiées en tant que paires clé-valeur et, si elles ne sont pas spécifiées dans les paires, une exception se produit. Vous pouvez récupérer une caractéristique en passant la clé à la GetTraitméthode ,
La spécification settings du moment où l’objet EventSource est construit vous permet de spécifier si l’événement est écrit dans un manifeste ou dans un format auto-décrivant. En outre, vous pouvez spécifier qu’une exception doit être levée lorsqu’une erreur se produit pendant le processus d’écriture d’événements.
Voir aussi
S’applique à
EventSource(String, EventSourceSettings)
Crée une instance de la EventSource classe avec le nom et les paramètres spécifiés.
public:
EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config);public EventSource(string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config);new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, config As EventSourceSettings)Paramètres
- eventSourceName
- String
Nom à appliquer à la source d’événement. Ne doit pas être null.
- config
- EventSourceSettings
Combinaison de bits des valeurs d’énumération qui spécifient les paramètres de configuration à appliquer à la source d’événement.
Exceptions
eventSourceName a la valeur null.
Remarques
La spécification settings du moment où l’objet EventSource est construit vous permet de spécifier si l’événement est écrit dans un manifeste ou dans un format auto-décrivant. En outre, vous pouvez spécifier qu’une exception doit être levée lorsqu’une erreur se produit pendant le processus d’écriture d’événements.
Lorsque vous utilisez ce constructeur, vérifiez que l’argument eventSourceName correspond au nom ETW défini par l’attribut EventSourceAttribute sur ce type. Sinon, les GUID retournés par la Guid propriété et la GetGuid(Type) méthode seront différents.
Dans ce cas, la Guid propriété retourne le GUID utilisé pour inscrire cet EventSource auprès d’ETW.
S’applique à
EventSource(String, EventSourceSettings, String[])
Crée une instance de la EventSource classe avec les paramètres de configuration spécifiés.
public:
EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config, ... cli::array <System::String ^> ^ traits);public EventSource(string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config, params string[] traits);new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, config As EventSourceSettings, ParamArray traits As String())Paramètres
- eventSourceName
- String
Nom à appliquer à la source d’événement. Ne doit pas être null.
- config
- EventSourceSettings
Combinaison de bits des valeurs d’énumération qui spécifient les paramètres de configuration à appliquer à la source d’événement.
- traits
- String[]
Paires clé-valeur qui spécifient des caractéristiques pour la source d’événement.
Exceptions
eventSourceName a la valeur null.
traits n’est pas spécifié dans les paires clé-valeur.
Remarques
Les caractéristiques fournissent des informations supplémentaires pour un événement et sont interprétées par un écouteur d’événement. Les caractéristiques sont spécifiées en tant que paires clé-valeur et, si elles ne sont pas spécifiées dans les paires, une exception se produit. Vous pouvez récupérer une caractéristique en passant la clé à la GetTraitméthode ,
La spécification config du moment où l’objet EventSource est construit vous permet de spécifier si l’événement est écrit dans un manifeste ou dans un format auto-décrivant. En outre, vous pouvez spécifier qu’une exception doit être levée lorsqu’une erreur se produit pendant le processus d’écriture d’événements.
Lorsque vous utilisez ce constructeur, vérifiez que l’argument eventSourceName correspond au nom ETW défini par l’attribut EventSourceAttribute sur ce type. Sinon, les GUID retournés par la Guid propriété et la GetGuid(Type) méthode seront différents.
Dans ce cas, le GUID utilisé pour inscrire cet EventSource auprès d’ETW est celui retourné par Guid.