Registry.PerformanceData フィールド
ソフトウェア コンポーネントのパフォーマンスに関する情報を格納しています。このフィールドには、Windows レジストリの基本キー HKEY_PERFORMANCE_DATA が読み込まれます。
Public Shared ReadOnly PerformanceData As RegistryKey
[C#]
public static readonly RegistryKey PerformanceData;
[C++]
public: static RegistryKey* PerformanceData;
[JScript]
public static var PerformanceData : RegistryKey;
解説
各ソフトウェア コンポーネントをインストールすると、そのコンポーネントのオブジェクト、つまりカウンタのキーが作成され、コンポーネントの実行時に、カウンタ データが書き込まれます。このデータにアクセスするには、その他のレジストリ データにアクセスする場合と同様に、 RegistryKey 関数を使用します。
レジストリを使用してパフォーマンス データを収集しますが、収集したデータはレジストリ データベースには格納されません。このキーが記述されているレジストリにアクセスすると、適切なシステム オブジェクト マネージャからデータが収集されます。
ローカル システムからパフォーマンス データを取得するには、Registry.PerformanceData キーを指定した GetValue メソッドを使用します。最初の呼び出しでこのキーが開かれます。初めにキーを明示的に開く必要はありません。パフォーマンス データの取得が完了したら、必ず Close メソッドを使用してこのキーへのハンドルを閉じてください。パフォーマンス データが使用されている間は、ユーザーはソフトウェア コンポーネントをインストールまたは削除できません。
リモート システムからパフォーマンス データを取得するには、リモート システムのコンピュータ名と Registry.PerformanceData キーを指定した OpenRemoteBaseKey メソッドを使用する必要があります。このメソッドを呼び出すと、リモート システムのパフォーマンス データを表すキーが取得されます。データを取得するには、Registry.PerformanceData キーではなくこのキーを使用して GetValue を呼び出します。
使用例
[Visual Basic, C#, C++] このキーのサブキーを取得し、これらのサブキーの名前を画面に出力する方法の例を次に示します。必要な特定のサブキーのインスタンスを作成するには、 OpenSubKey メソッドを使用します。次に、 RegistryKey で別の演算を使用して、そのキーを操作します。パフォーマンス データがない場合があるため、この例では結果が返されないことがある点に注意してください。
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
[C#]
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;
}
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace Microsoft::Win32;
void PrintKeys(RegistryKey* rkey) {
// Retrieve all the subkeys for the specified key.
String* names[] = rkey->GetSubKeyNames();
int icount = 0;
Console::WriteLine(S"Subkeys of {0}", rkey->Name);
Console::WriteLine(S"-----------------------------------------------");
// Print the contents of the array to the console.
System::Collections::IEnumerator* enum0 = names->GetEnumerator();
while (enum0->MoveNext())
{
String* s = __try_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);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ