PerformanceCounter Constructeurs

Référence

Définition

Espace de noms:: System.Diagnostics

Assembly:: System.Diagnostics.PerformanceCounter.dll

Assembly:: System.dll

Paquet:: System.Diagnostics.PerformanceCounter v6.0.0

Paquet:: System.Diagnostics.PerformanceCounter v7.0.0

Paquet:: System.Diagnostics.PerformanceCounter v8.0.0

Paquet:: System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5

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.

Initialise une nouvelle instance de la classe PerformanceCounter.

Surcharges

PerformanceCounter()	Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter, sans associer cette instance à un compteur de performance système ou personnalisé.
PerformanceCounter(String, String)	Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé spécifié de l'ordinateur local. Ce constructeur exige que la catégorie ait une seule instance.
PerformanceCounter(String, String, Boolean)	Initialise une nouvelle instance en lecture seule ou en lecture/écriture de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé spécifié de l'ordinateur local. Ce constructeur exige que la catégorie contienne une seule instance.
PerformanceCounter(String, String, String)	Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé et à l'instance de la catégorie spécifiés sur l'ordinateur local.
PerformanceCounter(String, String, String, Boolean)	Initialise une nouvelle instance en lecture seule ou en lecture/écriture de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé et à l'instance de la catégorie spécifiés sur l'ordinateur local.
PerformanceCounter(String, String, String, String)	Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé et à l'instance de la catégorie spécifiés sur l'ordinateur donné.

PerformanceCounter()

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter, sans associer cette instance à un compteur de performance système ou personnalisé.

public:
 PerformanceCounter();

public PerformanceCounter ();

Public Sub New ()

Exemples

L’exemple de code suivant crée une instance par défaut de la PerformanceCounter classe . Une fois le instance créé, les valeurs de propriété CategoryName, CounterNameet InstanceName sont définies et les résultats d’un appel à la NextValue méthode s’affichent.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Remarques

Cette surcharge du constructeur définit les CategoryNamepropriétés , CounterNameet InstanceName sur des chaînes vides (« »), et définit la MachineName propriété sur l’ordinateur local, (« . »).

Ce constructeur n’initialise pas le compteur de performances. Il n’associe donc pas le instance à un compteur existant sur l’ordinateur local. Pour pointer vers un compteur de performances spécifique, définissez les CategoryNamepropriétés , CounterNameet, éventuellement, les InstanceName propriétés et MachineName avant de lire d’autres propriétés ou de tenter de lire à partir d’un compteur. Pour écrire dans un compteur de performances, définissez la propriété sur ReadOnlyfalse.

Notes

L’attribut HostProtectionAttribute appliqué à ce membre a la valeur de propriété suivante Resources : | Synchronization SharedState . HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d’informations, consultez la HostProtectionAttribute classe ou SQL Server programmation et attributs de protection de l’hôte.

S’applique à

PerformanceCounter(String, String)

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé spécifié de l'ordinateur local. Ce constructeur exige que la catégorie ait une seule instance.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);

public PerformanceCounter (string categoryName, string counterName);

new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String)

Paramètres

categoryName: String

Nom de la catégorie de compteurs de performance (objet de performance) à laquelle ce compteur de performance est associé.

counterName: String

Nom du compteur de performance.

Exceptions

InvalidOperationException

Le categoryName est une chaîne vide ("").

- ou -

Le counterName est une chaîne vide ("").

- ou -

La catégorie spécifiée n'existe pas.

- ou -

La catégorie spécifiée est marquée comme multi-instance et requiert la création du compteur de performances avec un nom d’instance.

- ou -

categoryName et counterName ont été localisés dans des langages différents.

ArgumentNullException

categoryName ou counterName est null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

UnauthorizedAccessException

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Remarques

Les chaînes de paramètres ne respectent pas la casse.

Utilisez cette surcharge pour accéder à un compteur sur l’ordinateur local qui appartient à une catégorie contenant une seule catégorie de compteur de performances instance. Si vous tentez d’utiliser ce constructeur pour pointer ce PerformanceCounter instance vers une catégorie qui contient plusieurs instances, le constructeur lève une exception. Cette surcharge peut accéder à n’importe quel compteur en lecture seule ou en lecture/écriture, mais elle le fait en mode lecture seule. Une PerformanceCounter instance créée à l’aide de cette surcharge ne peut pas écrire dans le compteur, même si le compteur lui-même est en lecture/écriture.

Cette surcharge du constructeur définit les CategoryName propriétés et CounterName sur les valeurs que vous transmettez, définit la MachineName propriété sur l’ordinateur local, « . » et définit la InstanceName propriété sur une chaîne vide (« »).

Ce constructeur initialise le compteur de performances et associe le instance à un compteur existant (un système ou un compteur personnalisé) sur l’ordinateur local. Les valeurs que vous transmettez pour les CategoryName propriétés et CounterName doivent pointer vers un compteur de performances existant sur l’ordinateur local.

Notes

Pour lire les compteurs de performances à partir d’une session d’ouverture de session non interactive dans Windows Vista et versions ultérieures, Windows XP Professionnel Édition x64 ou Windows Server 2003, vous devez être membre du groupe Utilisateurs Analyseur de performances ou disposer de privilèges d’administrateur.

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe utilisateurs Analyseur de performances.

Dans Windows Vista, le contrôle de compte d'utilisateur détermine les privilèges d'un utilisateur. Si vous êtes membre du groupe Administrateurs intégrés, deux jetons d'accès au moment de l'exécution vous sont assignés : 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 aux compteurs de performances, vous devez d’abord élever vos privilèges d’utilisateur standard à administrateur. Vous pouvez effectuer cela au démarrage d'une application en cliquant avec le bouton droit sur l'icône de l'application et en indiquant que vous voulez l'exécuter en tant qu'administrateur.

S’applique à

PerformanceCounter(String, String, Boolean)

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Initialise une nouvelle instance en lecture seule ou en lecture/écriture de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé spécifié de l'ordinateur local. Ce constructeur exige que la catégorie contienne une seule instance.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

Paramètres

categoryName: String

Nom de la catégorie de compteurs de performance (objet de performance) à laquelle ce compteur de performance est associé.

counterName: String

Nom du compteur de performance.

readOnly: Boolean

true pour accéder au compteur en mode lecture seule (même si le compteur lui-même peut être en lecture/écriture) ; false pour accéder au compteur en mode lecture/écriture.

Exceptions

InvalidOperationException

categoryName est une chaîne vide ("").

- ou -

counterName est une chaîne vide ("").

- ou -

La catégorie spécifiée n'existe pas. (si readOnly est true).

- ou -

La catégorie spécifiée n'est pas une catégorie personnalisée de .NET Framework (si readOnly est false).

- ou -

La catégorie spécifiée est marquée comme multi-instance et requiert la création du compteur de performances avec un nom d’instance.

- ou -

categoryName et counterName ont été localisés dans des langages différents.

ArgumentNullException

categoryName ou counterName est null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

UnauthorizedAccessException

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Exemples

L’exemple de code suivant crée une instance de la PerformanceCounter classe . L’exemple montre comment transmettre des noms de catégorie, des noms de compteur et une valeur d’indicateur indiquant que le compteur n’est pas en lecture seule. Cet exemple de code fait partie d’un exemple plus grand pour la PerformanceCounter classe .

PC = gcnew PerformanceCounter( "AverageCounter64SampleCategory","AverageCounter64Sample",false );

avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
    "AverageCounter64Sample",
    false);

avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

Remarques

Les chaînes de paramètres ne respectent pas la casse.

Utilisez cette surcharge pour accéder à un compteur en lecture seule ou en lecture/écriture sur l’ordinateur local qui appartient à une catégorie contenant une seule catégorie de compteur de performances instance. Si vous tentez d’utiliser ce constructeur pour pointer ce PerformanceCounter instance vers une catégorie qui contient plusieurs instances, le constructeur lève une exception.

Cette surcharge du constructeur définit les CategoryNamepropriétés , CounterNameet sur ReadOnly les valeurs que vous transmettez, définit la MachineName propriété sur l’ordinateur local, « . » et définit la InstanceName propriété sur une chaîne vide (« »).

Notes

Vous pouvez utiliser cette surcharge pour vous connecter à un compteur système, mais vous ne pouvez pas écrire dans un compteur système. Par conséquent, la définition de readOnly sur false lors de la connexion à un compteur système entraîne la levée d’une exception par le constructeur.

Notes

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe utilisateurs Analyseur de performances.

S’applique à

PerformanceCounter(String, String, String)

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Initialise une nouvelle instance en lecture seule de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé et à l'instance de la catégorie spécifiés sur l'ordinateur local.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);

public PerformanceCounter (string categoryName, string counterName, string instanceName);

new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String)

Paramètres

categoryName: String

Nom de la catégorie de compteurs de performance (objet de performance) à laquelle ce compteur de performance est associé.

counterName: String

Nom du compteur de performance.

instanceName: String

Nom de l'instance de la catégorie de compteurs de performance, ou chaîne vide ("") si la catégorie contient une seule instance.

Exceptions

InvalidOperationException

Le categoryName est une chaîne vide ("").

- ou -

Le counterName est une chaîne vide ("").

- ou -

La valeur spécifiée n'est pas valide.

- ou -

La catégorie spécifiée est marquée comme multi-instance et requiert la création du compteur de performances avec un nom d’instance.

- ou -

instanceName dépasse 127 caractères.

- ou -

categoryName et counterName ont été localisés dans des langages différents.

ArgumentNullException

categoryName ou counterName est null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

UnauthorizedAccessException

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Remarques

Les chaînes de paramètres ne respectent pas la casse.

Cette surcharge du constructeur définit les CategoryNamepropriétés , CounterNameet sur InstanceName les valeurs que vous passez, et définit la MachineName propriété sur l’ordinateur local, « ».

Ce constructeur initialise le compteur de performances et associe le instance à un compteur existant (système ou compteur personnalisé) sur l’ordinateur local. Les valeurs que vous transmettez pour les CategoryNamepropriétés , CounterNameet InstanceName doivent pointer vers un compteur de performances existant sur l’ordinateur local. Si le compteur de performances instance que vous pointez n’est pas valide, l’appel du constructeur lève une exception.

Cette surcharge peut accéder à n’importe quel compteur en lecture seule ou en lecture/écriture, mais elle le fait en mode lecture seule. Une PerformanceCounter instance créée à l’aide de cette surcharge ne peut pas écrire dans le compteur, même si le compteur lui-même est en lecture/écriture.

Pour créer une catégorie de performances instance, spécifiez un instanceName sur le PerformanceCounter constructeur. Si la catégorie instance spécifiée par instanceName existe déjà, le nouvel objet référencera la catégorie existante instance.

Notes

Pour lire les compteurs de performances dans Windows Vista, Windows XP Professionnel Édition x64 ou Windows Server 2003, vous devez être membre du groupe Analyseur de performances Utilisateurs ou disposer de privilèges d’administrateur.

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe Analyseur de performances Utilisateurs.

S’applique à

PerformanceCounter(String, String, String, Boolean)

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Initialise une nouvelle instance en lecture seule ou en lecture/écriture de la classe PerformanceCounter et l'associe au compteur de performance système ou personnalisé et à l'instance de la catégorie spécifiés sur l'ordinateur local.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, string instanceName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

Paramètres

categoryName: String

Nom de la catégorie de compteurs de performance (objet de performance) à laquelle ce compteur de performance est associé.

counterName: String

Nom du compteur de performance.

instanceName: String

Nom de l'instance de la catégorie de compteurs de performance, ou chaîne vide ("") si la catégorie contient une seule instance.

readOnly: Boolean

true pour accéder à un compteur en mode lecture seule ; false pour accéder à un compteur en mode lecture/écriture.

Exceptions

InvalidOperationException

Le categoryName est une chaîne vide ("").

- ou -

Le counterName est une chaîne vide ("").

- ou -

Le paramètre d’autorisation de lecture/écriture demandé n’est pas valide pour ce compteur.

- ou -

La catégorie spécifiée n'existe pas (si readOnly est true).

- ou -

La catégorie spécifiée n'est pas une catégorie personnalisée de .NET Framework (si readOnly est false).

- ou -

La catégorie spécifiée est marquée comme multi-instance et requiert la création du compteur de performances avec un nom d’instance.

- ou -

instanceName dépasse 127 caractères.

- ou -

categoryName et counterName ont été localisés dans des langages différents.

ArgumentNullException

categoryName ou counterName est null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

UnauthorizedAccessException

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Remarques

Les chaînes de paramètres ne respectent pas la casse.

Utilisez cette surcharge pour accéder à un compteur de performances en lecture seule ou en lecture/écriture.

Cette surcharge du constructeur définit les CategoryNamepropriétés , CounterNameet sur InstanceName les valeurs que vous transmettez, et définit la MachineName propriété sur l’ordinateur local, « . »

Ce constructeur initialise le compteur de performances et associe le instance à un compteur existant (système ou compteur personnalisé) sur l’ordinateur local. Les valeurs que vous transmettez pour les CategoryNamepropriétés , CounterNameet InstanceName doivent pointer vers un compteur de performances existant sur l’ordinateur local. Si le compteur de performances instance vers lequel vous pointez n’est pas valide, l’appel du constructeur lève une exception.

Notes

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe Analyseur de performances Utilisateurs.

S’applique à

PerformanceCounter(String, String, String, String)

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

Source:: PerformanceCounter.cs

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);

public PerformanceCounter (string categoryName, string counterName, string instanceName, string machineName);

new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

Paramètres

categoryName: String

Nom de la catégorie de compteurs de performance (objet de performance) à laquelle ce compteur de performance est associé.

counterName: String

Nom du compteur de performance.

instanceName: String

Nom de l'instance de la catégorie de compteurs de performance, ou chaîne vide ("") si la catégorie contient une seule instance.

machineName: String

Ordinateur sur lequel se situent le compteur de performance et la catégorie qui lui est associée.

Exceptions

InvalidOperationException

Le categoryName est une chaîne vide ("").

- ou -

Le counterName est une chaîne vide ("").

- ou -

Le paramètre d’autorisation de lecture/écriture demandé n’est pas valide pour ce compteur.

- ou -

Le compteur n'existe pas sur l'ordinateur spécifié.

- ou -

La catégorie spécifiée est marquée comme multi-instance et requiert la création du compteur de performances avec un nom d’instance.

- ou -

instanceName dépasse 127 caractères.

- ou -

categoryName et counterName ont été localisés dans des langages différents.

ArgumentException

Le paramètre machineName n'est pas valide.

ArgumentNullException

categoryName ou counterName est null.

Win32Exception

Une erreur s'est produite lors de l'accès à une API système.

UnauthorizedAccessException

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Remarques

Les chaînes de paramètres ne respectent pas la casse.

Cette surcharge du constructeur définit les CategoryNamepropriétés , CounterName, InstanceNameet MachineName sur les valeurs que vous transmettez.

Ce constructeur initialise le compteur de performances et associe le instance à un compteur existant (un système ou un compteur personnalisé) sur l’ordinateur spécifié. Les valeurs que vous transmettez pour les CategoryNamepropriétés , CounterName InstanceName et MachineName doivent pointer vers un compteur de performances existant. Si le compteur de performances vers instance lequel vous pointez n’est pas valide, l’appel du constructeur lève une exception. Cette surcharge peut accéder à n’importe quel compteur en lecture seule ou en lecture/écriture, mais elle le fait en mode lecture seule. Une PerformanceCounter instance créée à l’aide de cette surcharge ne peut pas écrire dans le compteur, même si le compteur lui-même est en lecture/écriture.

Notes

Vous ne pouvez pas écrire dans des compteurs de performances distants. Il n’existe aucune surcharge qui vous permet de spécifier une instance de lecture/écriture de la PerformanceCounter classe qui se connecte à un ordinateur distant.

Notes

Pour lire les compteurs de performances dans Windows Vista, Windows XP Professionnel Édition x64 ou Windows Server 2003, vous devez être membre du groupe Utilisateurs Analyseur de performances ou disposer de privilèges d’administrateur.

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe utilisateurs Analyseur de performances.

Notes

Dans Windows Vista, lorsque l’ordinateur distant est membre d’un groupe de travail, vous devrez peut-être désactiver la UAC afin que le compte d’utilisateur local ne soit pas filtré et puisse être élevé à un compte d’administrateur. Pour des raisons de sécurité, la désactivation de la UAC doit être un dernier recours. Pour plus d’informations sur la désactivation de L’UAC, consultez Contrôle de compte d’utilisateur et WMI.

S’applique à

Partager via

PerformanceCounter Constructeurs

Définition

Surcharges

PerformanceCounter()

Exemples

Remarques

S’applique à

PerformanceCounter(String, String)

Paramètres

Exceptions

Remarques

S’applique à

PerformanceCounter(String, String, Boolean)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

PerformanceCounter(String, String, String)

Paramètres

Exceptions

Remarques

S’applique à

PerformanceCounter(String, String, String, Boolean)

Paramètres

Exceptions

Remarques

S’applique à

PerformanceCounter(String, String, String, String)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires