RegistryKey.GetValueNames メソッド

.NET Framework クラス ライブラリ リファレンス

RegistryKey.GetValueNames メソッド

このキーに関連付けられているすべての値の名前が格納されている文字列の配列を取得します。

名前空間: Microsoft.Win32
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function GetValueNames As
 String()

Visual Basic (使用法)

Dim instance As RegistryKey
Dim returnValue As String()

returnValue = instance.GetValueNames

C#

public string[] GetValueNames ()

C++

public:
array<String^>^ GetValueNames ()

J#

public String[] GetValueNames ()

JScript

public function GetValueNames () : String[]

戻り値
現在のキーの値の名前を格納する文字列の配列。

例外

例外の種類	条件
SecurityException	ユーザーに、レジストリ キーからの読み取りに必要なアクセス許可がありません。
ObjectDisposedException	操作対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。
UnauthorizedAccessException	ユーザーに、必要なレジストリ権限がありません。
IOException	システム エラーが発生しました。たとえば、現在のキーが削除されています。

解説

キーの値の名前が見つからない場合は、空の配列が返されます。

レジストリ キーには、名前/値ペアの名前が空の文字列 ("") である場合の既定値を設定できます。レジストリ キーに既定値が設定されている場合、GetValueNames メソッドから返された配列には空の文字列が格納されます。

使用例

このコード例は、RegistryKey クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Print the information from the Test9999 subkey.
Console.WriteLine("There are {0} subkeys under Test9999.",
 _
    test9999.SubKeyCount.ToString())
For Each subKeyName As String
 In test9999.GetSubKeyNames()
    Dim tempKey As RegistryKey = _
        test9999.OpenSubKey(subKeyName)
    Console.WriteLine(vbCrLf & "There are {0} values for "
 & _
        "{1}.", tempKey.ValueCount.ToString(), tempKey.Name)
    For Each valueName As
 String In tempKey.GetValueNames()
        Console.WriteLine("{0,-8}: {1}", valueName,
 _
            tempKey.GetValue(valueName).ToString())
    Next
Next

C#

// Print the information from the Test9999 subkey.
Console.WriteLine("There are {0} subkeys under {1}.", 
    test9999.SubKeyCount.ToString(), test9999.Name);
foreach(string subKeyName in
 test9999.GetSubKeyNames())
{
    using(RegistryKey 
        tempKey = test9999.OpenSubKey(subKeyName))
    {
        Console.WriteLine("\nThere are {0} values for {1}.",
 
            tempKey.ValueCount.ToString(), tempKey.Name);
        foreach(string valueName in
 tempKey.GetValueNames())
        {
            Console.WriteLine("{0,-8}: {1}", valueName, 
                tempKey.GetValue(valueName).ToString());
        }
    }
}

C++

// Print the information from the Test9999 subkey.
Console::WriteLine( "There are {0} subkeys under Test9999.", test9999->SubKeyCount.ToString()
 );
array<String^>^subKeyNames = test9999->GetSubKeyNames();
for ( int i = 0; i < subKeyNames->Length;
 i++ )
{
   RegistryKey ^ tempKey = test9999->OpenSubKey( subKeyNames[ i ] );
   Console::WriteLine( "\nThere are {0} values for {1}.",
 tempKey->ValueCount.ToString(), tempKey->Name );
   array<String^>^valueNames = tempKey->GetValueNames();
   for ( int j = 0; j < valueNames->Length;
 j++ )
   {
      Console::WriteLine( "{0,-8}: {1}", valueNames[ j ], tempKey->GetValue(
 valueNames[ j ] )->ToString() );

   }
}

.NET Framework のセキュリティ

• RegistryPermission  (レジストリから読み取るために必要なアクセス許可)。RegistryPermissionAccess.Read (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
RegistryKey クラス
RegistryKey メンバ
Microsoft.Win32 名前空間
GetValue
GetSubKeyNames