Registry.PerformanceData Champ

Définition

Espace de noms:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

Contient des informations sur les performances des composants logiciels. Ce champ lit la clé de base HKEY_PERFORMANCE_DATA du Registre Windows.

public: static initonly Microsoft::Win32::RegistryKey ^ PerformanceData;

public static readonly Microsoft.Win32.RegistryKey PerformanceData;

 staticval mutable PerformanceData : Microsoft.Win32.RegistryKey

Public Shared ReadOnly PerformanceData As RegistryKey 

Valeur de champ

RegistryKey

Exemples

L’exemple suivant montre comment récupérer les sous-clés de cette clé et imprimer leurs noms à l’écran. Utilisez la OpenSubKey méthode pour créer une instance de la sous-clé particulière qui vous intéresse. Vous pouvez ensuite utiliser d’autres opérations dans RegistryKey pour manipuler cette clé. Notez que cet exemple ne retourne souvent aucun résultat, car il peut ne pas y avoir de données de performances.

using namespace System;
using namespace Microsoft::Win32;
void PrintKeys( RegistryKey ^ rkey )
{
   
   // Retrieve all the subkeys for the specified key.
   array<String^>^names = rkey->GetSubKeyNames();
   int icount = 0;
   Console::WriteLine( "Subkeys of {0}", rkey->Name );
   Console::WriteLine( "-----------------------------------------------" );
   
   // Print the contents of the array to the console.
   System::Collections::IEnumerator^ enum0 = names->GetEnumerator();
   while ( enum0->MoveNext() )
   {
      String^ s = safe_cast<String^>(enum0->Current);
      Console::WriteLine( s );
      
      // The following code puts a limit on the number
      // of keys displayed.  Comment it out to print the
      // complete list.
      icount++;
      if ( icount >= 10 )
            break;
   }
}

int main()
{
   
   // Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA
   // key in the registry of this machine.
   RegistryKey ^ rk = Registry::PerformanceData;
   
   // Print out the keys.
   PrintKeys( rk );
}

using System;
using Microsoft.Win32;

class Reg {
    public static void Main() {

        // Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA
        // key in the registry of this machine.
        RegistryKey rk = Registry.PerformanceData;

        // Print out the keys.
        PrintKeys(rk);
    }

    static void PrintKeys(RegistryKey rkey) {

        // Retrieve all the subkeys for the specified key.
        string [] names = rkey.GetSubKeyNames();

        int icount = 0;

        Console.WriteLine("Subkeys of " + rkey.Name);
        Console.WriteLine("-----------------------------------------------");

        // Print the contents of the array to the console.
        foreach (string s in names) {
            Console.WriteLine(s);

            // The following code puts a limit on the number
            // of keys displayed.  Comment it out to print the
            // complete list.
            icount++;
            if (icount >= 10)
                break;
        }
    }
}

Imports Microsoft.Win32

Class Reg
    
    Public Shared Sub Main()
        
        ' Create a RegistryKey, which will access the HKEY_PERFORMANCE_DATA 
        ' key in the registry of this machine.
        Dim rk As RegistryKey = Registry.PerformanceData
        
        ' Print out the keys.
        PrintKeys(rk)
    End Sub    
    
    Shared Sub PrintKeys(rkey As RegistryKey)
        
        ' Retrieve all the subkeys for the specified key.
        Dim names As String() = rkey.GetSubKeyNames()
        
        Dim icount As Integer = 0
        
        Console.WriteLine("Subkeys of " & rkey.Name)
        Console.WriteLine("-----------------------------------------------")
        
        ' Print the contents of the array to the console.
        Dim s As String
        For Each s In  names
            Console.WriteLine(s)
            
            ' The following code puts a limit on the number
            ' of keys displayed.  Comment it out to print the
            ' complete list.
            icount += 1            
            If icount >= 10 Then
                Exit For
            End If
        Next s
    End Sub
End Class

Remarques

Chaque composant logiciel crée des clés pour ses objets, compteurs lorsqu’il est installé et écrit les données du compteur pendant son exécution. Vous pouvez accéder à ces données comme vous le feriez pour toutes les autres données du Registre, à l’aide des RegistryKey fonctions .

Bien que vous utilisiez le Registre pour collecter des données de performances, les données ne sont pas stockées dans la base de données du Registre. Au lieu de cela, l’accès au Registre avec cette clé amène le système à collecter les données des gestionnaires d’objets système appropriés.

Pour obtenir des données de performances à partir du système local, utilisez la GetValue méthode, avec la clé Registry.PerformanceData. Le premier appel ouvre la clé (vous n’avez pas besoin d’ouvrir explicitement la clé en premier). Toutefois, veillez à utiliser la Close méthode pour fermer le handle à la clé lorsque vous avez terminé d’obtenir des données de performances. L’utilisateur ne peut pas installer ou supprimer un composant logiciel tant que ses données de performances sont en cours d’utilisation.

Pour obtenir des données de performances à partir d’un système distant, vous devez utiliser la OpenRemoteBaseKey méthode, avec le nom d’ordinateur du système distant et la clé Registry.PerformanceData. Cet appel récupère une clé représentant les données de performances du système distant. Pour récupérer les données, appelez GetValue à l’aide de cette clé plutôt que de la clé Registry.PerformanceData.

Notes

Sur Windows Server 2003, un utilisateur doit au moins appartenir au groupe utilisateurs Analyseur de performances pour accéder aux sous-clés de cette clé de base.