Registry.PerformanceData Feld

Definition

Namespace:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

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

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 

Feldwert

RegistryKey

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Unterschlüssel dieses Schlüssels abgerufen und ihre Namen auf dem Bildschirm ausgegeben werden. Verwenden Sie die OpenSubKey -Methode, um eine instance des jeweiligen Unterschlüssels von Interesse zu erstellen. Sie können dann andere Vorgänge in RegistryKey verwenden, um diesen Schlüssel zu bearbeiten. Beachten Sie, dass in diesem Beispiel häufig keine Ergebnisse zurückgegeben werden können, da möglicherweise keine Leistungsdaten vorhanden sind.

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

Hinweise

Jede Softwarekomponente erstellt Schlüssel für ihre Objekte, Leistungsindikatoren, wenn sie installiert wird, und schreibt Während der Ausführung Zählerdaten. Sie können auf diese Daten wie auf andere Registrierungsdaten zugreifen, indem Sie die RegistryKey Funktionen verwenden.

Obwohl Sie die Registrierung zum Sammeln von Leistungsdaten verwenden, werden die Daten nicht in der Registrierungsdatenbank gespeichert. Stattdessen führt der Zugriff auf die Registrierung mit diesem Schlüssel dazu, dass das System die Daten von den entsprechenden Systemobjekt-Managern sammelt.

Verwenden Sie zum Abrufen von Leistungsdaten aus dem lokalen System die GetValue -Methode mit dem Schlüssel Registry.PerformanceData. Beim ersten Aufruf wird der Schlüssel geöffnet (Sie müssen den Schlüssel nicht explizit zuerst öffnen). Stellen Sie jedoch sicher, dass Sie die Close -Methode verwenden, um das Handle mit dem Schlüssel zu schließen, wenn Sie mit dem Abrufen von Leistungsdaten fertig sind. Der Benutzer kann eine Softwarekomponente nicht installieren oder entfernen, während ihre Leistungsdaten verwendet werden.

Um Leistungsdaten von einem Remotesystem abzurufen, müssen Sie die OpenRemoteBaseKey -Methode mit dem Computernamen des Remotesystems und dem Schlüssel Registry.PerformanceData verwenden. Dieser Aufruf ruft einen Schlüssel ab, der die Leistungsdaten für das Remotesystem darstellt. Rufen GetValue Sie zum Abrufen der Daten mithilfe dieses Schlüssels anstelle des Schlüssels Registry.PerformanceData auf.

Hinweis

Unter Windows Server 2003 muss ein Benutzer mindestens der Gruppe Leistungsmonitor Benutzer angehören, um auf Unterschlüssel dieses Basisschlüssels zugreifen zu können.