RegistryKey.GetValueNames 方法

定义

命名空间:

Microsoft.Win32

程序集:

Microsoft.Win32.Registry.dll

检索包含与此项关联的所有值名称的字符串数组。

public:
 cli::array <System::String ^> ^ GetValueNames();

public string[] GetValueNames ();

member this.GetValueNames : unit -> string[]

Public Function GetValueNames () As String()

返回

String[]

包含当前项的值名称的字符串数组。

例外

SecurityException

该用户没有读取注册表项所需的权限。

ObjectDisposedException

要操作的 RegistryKey 已关闭（无法访问关闭的项）。

UnauthorizedAccessException

用户没有必需的注册表权限。

IOException

发生系统错误；例如，当前项已被删除。

示例

此代码示例是为 RegistryKey 类提供的一个更大示例的一部分。

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

   }
}

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

' 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

注解

如果未找到键的值名称，则返回空数组。

注册表项可以具有默认值 - 即名称/值对，其中名称为空字符串 (“”) 。 如果已为注册表项设置了默认值，则 方法返回的 GetValueNames 数组将包含空字符串。

另请参阅

• GetValue(String)
• GetSubKeyNames()