RegistryKey.GetValueNames メソッドとは何？わかりやすく解説 Weblio辞書

.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

public string[] GetValueNames ()

C++

public:
array<String^>^ GetValueNames ()

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

// 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() );

   }
}