次の方法で共有

RegistryKey.GetValue メソッド (String)

  • [アーティクル]

指定した値に関連付けられているデータを取得します。値が存在しない場合には null を取得します。

Overloads Public Function GetValue( _
   ByVal name As String _) As Object
[C#]
public object GetValue(stringname);
[C++]
public: Object* GetValue(String* name);
[JScript]
public function GetValue(
   name : String) : Object;

パラメータ

  • name
    取得する値の名前。

戻り値

name に関連付けられているデータ。値が存在しない場合は null。

例外

例外の種類 条件
SecurityException このユーザーには、RegistryPermission.SetInclude(read, currentKey) アクセス許可がありません。
ObjectDisposedException 操作対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。
ArgumentException 操作対象の RegistryKey が存在しません。

解説

name パラメータでは大文字と小文字が区別されません。

特定の registrykey の既定値を取得するには、name に null 参照 (Visual Basic では Nothing) または空の文字列 ("") を指定できます。

レジストリから取得される値は、DWORD、バイナリ、または文字列です。文字列値は、次のカテゴリとして表されます。

  • sz: データは、null で終わる Unicode 文字列値として表されます。
  • multi_sz: データは、null で終わる Unicode 文字列の配列として表されます。
  • expanded_sz: データは、環境変数への展開された参照を含む null で終わる Unicode 文字列として表されます。

メモ   REG_SZ の値を取得する場合、reg_sz 値が展開された値を表すことがあります。この場合、必要に応じて値を展開する ExpandEnvironmentVariables を呼び出してください。

SetValue を使用する場合は、保存する値型を指定できません。代わりに、渡される情報のデータ型に基づいてデータが解釈されます。文字列は expanded_sz 値ではなく、sz 値として解釈されます。

メモ   GetValue を使用して PerformanceData キーの値を返すことはできません。これは、GetValue を実行するたびにこのデータのサイズが異なる可能性があり、このメソッドでは正しいサイズの値を取得するためのバッファを割り当てることができないからです。元のパフォーマンス データにアクセスするには、代わりに PerformanceCounters を使用します。

使用例

[Visual Basic, C#, C++] 次のコード例は RegistryKey クラスの例の一部です。

 
' 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(S"There are {0} subkeys under Test9999.", 
    test9999->SubKeyCount.ToString());
String* subKeyNames __gc [] = test9999->GetSubKeyNames();
for(int i =0; i < subKeyNames->Length; i++)
{
    RegistryKey* tempKey = test9999->OpenSubKey(subKeyNames[i]);
    Console::WriteLine(S"\nThere are {0} values for {1}.", 
        tempKey->ValueCount.ToString(), tempKey->Name);
    String* valueNames __gc [] = tempKey->GetValueNames();
    for(int j = 0; j < valueNames->Length; j++)
    {
        Console::WriteLine(S"{0,-8}: {1}", valueNames[j], 
            tempKey->GetValue(valueNames[j])->ToString());
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

RegistryKey クラス | RegistryKey メンバ | Microsoft.Win32 名前空間 | RegistryKey.GetValue オーバーロードの一覧 | GetValueNames | SetValue | DeleteValue | ValueCount | GetSubKeyNames