Registry.PerformanceData Field

Definition

Contient des informations sur les performances des composants logiciels.Contains performance information for software components. Ce champ lit la clé de base HKEY_PERFORMANCE_DATA du Registre Windows.This field reads the Windows registry base key HKEY_PERFORMANCE_DATA.

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 

Field Value

RegistryKey

Examples

L’exemple suivant montre comment récupérer les sous-clés de cette clé et imprime leurs noms à l’écran.The following example demonstrates how to retrieve the subkeys of this key, and prints their names to the screen. Utilisez la méthode OpenSubKey pour créer une instance de la sous-clé particulière qui vous intéresse.Use the OpenSubKey method to create an instance of the particular subkey of interest. Vous pouvez ensuite utiliser d’autres opérations dans RegistryKey pour manipuler cette clé.You can then use other operations in RegistryKey to manipulate that key. Notez que cet exemple ne retourne souvent aucun résultat, car il est possible qu’il n’y ait pas de données de performances.Note that this example can often return no results, since there might be no performance data.

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

Remarks

Chaque composant logiciel crée des clés pour ses objets, compteurs lorsqu’il est installé et écrit des données de compteur pendant son exécution.Each software component creates keys for its objects, counters when it is installed, and writes counter data while it is executing. Vous pouvez accéder à ces données comme vous le feriez pour d’autres données du Registre, à l’aide des fonctions RegistryKey.You can access this data as you would access any other registry data, using the RegistryKey functions.

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.Although you use the registry to collect performance data, the data is not stored in the registry database. Au lieu de cela, l’accès au registre avec cette clé amène le système à collecter les données à partir des gestionnaires d’objets système appropriés.Instead, accessing the registry with this key causes the system to collect the data from the appropriate system object managers.

Pour obtenir les données de performances du système local, utilisez la méthode GetValue, avec la clé Registry. PerformanceData.To obtain performance data from the local system, use the GetValue method, with the Registry.PerformanceData key. Le premier appel ouvre la clé (vous n’avez pas besoin d’ouvrir la clé explicitement en premier).The first call opens the key (you do not need to explicitly open the key first). Toutefois, veillez à utiliser la méthode Close pour fermer le descripteur de la clé lorsque vous avez fini d’obtenir des données de performances.However, be sure to use the Close method to close the handle to the key when you are finished obtaining performance data. L’utilisateur ne peut pas installer ou supprimer un composant logiciel lorsque ses données de performances sont en cours d’utilisation.The user cannot install or remove a software component while its performance data is in use.

Pour obtenir des données de performances à partir d’un système distant, vous devez utiliser la méthode OpenRemoteBaseKey, avec le nom d’ordinateur du système distant et la clé Registry. PerformanceData.To obtain performance data from a remote system, you must use the OpenRemoteBaseKey method, with the computer name of the remote system and the Registry.PerformanceData key. Cet appel récupère une clé représentant les données de performances du système distant.This call retrieves a key representing the performance data for the remote system. Pour récupérer les données, appelez GetValue à l’aide de cette clé, plutôt que de la clé Registry. PerformanceData.To retrieve the data, call GetValue using this key, rather than the Registry.PerformanceData key.

Note

Sur Windows Server 2003, un utilisateur doit au moins appartenir au groupe utilisateurs de l’analyseur de performances afin d’accéder aux sous-clés de cette clé de base.On Windows Server 2003, a user must at least belong to the Performance Monitor Users group in order to access subkeys of this base key.

Applies to