Registry.PerformanceData-Feld

Enthält Leistungsinformationen für Softwarekomponenten. Dieses Feld liest den Basisschlüssel HKEY_PERFORMANCE_DATA der Windows-Registrierung.

Namespace: Microsoft.Win32
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared ReadOnly PerformanceData As RegistryKey
'Usage
Dim value As RegistryKey

value = Registry.PerformanceData

public static readonly RegistryKey PerformanceData

public:
static initonly RegistryKey^ PerformanceData

public static final RegistryKey PerformanceData

public static final var PerformanceData : RegistryKey

Hinweise

Von jeder Softwarekomponente werden Schlüssel für die zugehörigen Objekte erstellt. Bei der Installation werden Zähler erstellt, und während der Ausführung werden Zählerdaten geschrieben. Sie können auf diese Daten wie auf andere Registrierungsdaten mithilfe der RegistryKey-Funktionen zugreifen.

Obwohl Sie die Leistungsdaten über die Registrierung abrufen, sind die Daten nicht in der Registrierungsdatenbank gespeichert. Stattdessen ruft das System beim Zugriff auf diesen Registrierungsschlüssel Daten bei den entsprechenden Objektmanagern des Systems ab.

Verwenden Sie zum Abrufen von Leistungsdaten des lokalen Systems die GetValue-Methode mit dem Schlüssel Registry.PerformanceData. Der erste Aufruf öffnet den Schlüssel, Sie müssen den Schlüssel zuvor nicht explizit öffnen. Nach dem Abrufen der Leistungsdaten müssen Sie das Handle für den Schlüssel unbedingt mit der Close-Methode schließen. Benutzer können keine Softwarekomponenten installieren oder entfernen, solange deren Leistungsdaten in Benutzung sind.

Leistungsdaten von Remotesystemen müssen über die OpenRemoteBaseKey-Methode mit dem Computernamen des Remotesystems und dem Schlüssel Registry.PerformanceData abgerufen werden. Dieser Aufruf ruft einen Schlüssel ab, der die Leistungsdaten des Remotesystems darstellt. Rufen Sie zum Abrufen der Daten GetValue mit diesem Schlüssel und nicht mit dem Schlüssel Registry.PerformanceData auf.

Beispiel

Im folgenden Beispiel wird das Abrufen von Unterschlüsseln aus diesem Schlüssel veranschaulicht. Die Namen werden dann auf dem Bildschirm ausgegeben. Erstellen Sie mit der OpenSubKey-Methode eine Instanz des betreffenden Unterschlüssels. Mit den weiteren Operationen von RegistryKey können Sie diesen Schlüssel verändern. Beachten Sie, dass bei diesem Beispiel häufig keine Ergebnisse zurückgegeben werden, da möglicherweise keine Leistungsdaten vorhanden sind.

Imports System
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

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;
        }
    }
}

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 );
}

import System.*;
import Microsoft.Win32.*;

class Reg
{
    public static void main(String[] args)
    {
        // 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);
    } //main

    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.get_Name());
        Console.WriteLine("-----------------------------------------------");
        // Print the contents of the array to the console.
        String s = null;
        for (int iCtr = 0; iCtr < names.get_Length(); iCtr++) {
            s = names[iCtr];
            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;
            }
        }
    } //PrintKeys
} //Reg

Plattformen

Windows 2000 SP4, Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Registry-Klasse
Registry-Member
Microsoft.Win32-Namespace