RegistryKey.GetValue メソッド

定義

指定した名前に関連付けられている値を取得します。Retrieves the value associated with the specified name.

オーバーロード

GetValue(String, Object, RegistryValueOptions)

指定した名前に関連付けられている値を、取得オプションを指定して取得します。Retrieves the value associated with the specified name and retrieval options. 名前が見つからない場合、設定されている既定値を返します。If the name is not found, returns the default value that you provide.

GetValue(String)

指定した名前に関連付けられている値を取得します。Retrieves the value associated with the specified name. 名前/値ペアがレジストリに存在しない場合、null を返します。Returns null if the name/value pair does not exist in the registry.

GetValue(String, Object)

指定した名前に関連付けられている値を取得します。Retrieves the value associated with the specified name. 名前が見つからない場合、設定されている既定値を返します。If the name is not found, returns the default value that you provide.

GetValue(String, Object, RegistryValueOptions)

指定した名前に関連付けられている値を、取得オプションを指定して取得します。Retrieves the value associated with the specified name and retrieval options. 名前が見つからない場合、設定されている既定値を返します。If the name is not found, returns the default value that you provide.

public:
 System::Object ^ GetValue(System::String ^ name, System::Object ^ defaultValue, Microsoft::Win32::RegistryValueOptions options);
public object GetValue (string name, object defaultValue, Microsoft.Win32.RegistryValueOptions options);
public object? GetValue (string? name, object? defaultValue, Microsoft.Win32.RegistryValueOptions options);
[System.Runtime.InteropServices.ComVisible(false)]
public object GetValue (string name, object defaultValue, Microsoft.Win32.RegistryValueOptions options);
member this.GetValue : string * obj * Microsoft.Win32.RegistryValueOptions -> obj
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetValue : string * obj * Microsoft.Win32.RegistryValueOptions -> obj
Public Function GetValue (name As String, defaultValue As Object, options As RegistryValueOptions) As Object

パラメーター

name
String

取得する値の名前。The name of the value to retrieve. この文字列の大文字と小文字は区別されません。This string is not case-sensitive.

defaultValue
Object

name が存在しない場合に返す値。The value to return if name does not exist.

options
RegistryValueOptions

取得した値のオプションの処理を指定する列挙値の 1 つ。One of the enumeration values that specifies optional processing of the retrieved value.

戻り値

Object

name に関連付けられた値を、指定した options に従って処理したもの。defaultValue が見つからなかった場合は nameThe value associated with name, processed according to the specified options, or defaultValue if name is not found.

属性

例外

ユーザーに、レジストリ キーからの読み取りに必要なアクセス許可がありません。The user does not have the permissions required to read from the registry key.

指定された値を格納している RegistryKey が閉じています。閉じられたキーにはアクセスできません。The RegistryKey that contains the specified value is closed (closed keys cannot be accessed).

指定された値を格納する RegistryKey は、削除対象としてマークされています。The RegistryKey that contains the specified value has been marked for deletion.

options が有効な RegistryValueOptions 値ではありません。たとえば、無効な値が RegistryValueOptions にキャストされています。options is not a valid RegistryValueOptions value; for example, an invalid value is cast to RegistryValueOptions.

ユーザーに、必要なレジストリ権限がありません。The user does not have the necessary registry rights.

次のコードサンプルでは、テストキーを作成し、埋め込み環境変数を使用して値を追加し、展開されたフォームと展開されていないフォームの両方で値を取得します。The following code sample creates a test key, adds a value with an embedded environment variable, and retrieves the value in both expanded and unexpanded forms.

#using <Microsoft.VisualBasic.dll>

using namespace System;
using namespace Microsoft::Win32;
using namespace Microsoft::VisualBasic;

int main()
{
    // Delete and recreate the test key.
    Registry::CurrentUser->DeleteSubKey( L"RegistryValueOptionsExample", false );
    RegistryKey ^ rk = 
        Registry::CurrentUser->CreateSubKey( L"RegistryValueOptionsExample" );
   
    // Add a value that contains an environment variable.
    rk->SetValue( L"ExpandValue", L"The path is %PATH%", 
        RegistryValueKind::ExpandString );
   
    // Retrieve the value, first without expanding the environment
    // variable and then expanding it.
    Console::WriteLine( L"Unexpanded: \"{0}\"", 
                        rk->GetValue( L"ExpandValue", 
                        L"No Value", 
                        RegistryValueOptions::DoNotExpandEnvironmentNames ) );
    Console::WriteLine( L"Expanded: \"{0}\"", rk->GetValue( L"ExpandValue" ) );
 
    return 0;
} //Main
using System;
using Microsoft.Win32;
using Microsoft.VisualBasic;

public class Example
{
    public static void Main()
    {
        // Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryValueOptionsExample", false);
        RegistryKey rk =
            Registry.CurrentUser.CreateSubKey("RegistryValueOptionsExample");

        // Add a value that contains an environment variable.
        rk.SetValue("ExpandValue", "The path is %PATH%", RegistryValueKind.ExpandString);

        // Retrieve the value, first without expanding the environment
        // variable and then expanding it.
        Console.WriteLine("Unexpanded: \"{0}\"",
            rk.GetValue("ExpandValue", "No Value",
            RegistryValueOptions.DoNotExpandEnvironmentNames));
        Console.WriteLine("Expanded: \"{0}\"", rk.GetValue("ExpandValue"));
    } //Main
} //Example
Imports Microsoft.Win32

Public Class Example
    Public Shared Sub Main()
        ' Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryValueOptionsExample", False)
        Dim rk As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("RegistryValueOptionsExample")

        ' Add a value that contains an environment variable.
        rk.SetValue("ExpandValue", "The path is %PATH%", _
            RegistryValueKind.ExpandString)

        ' Retrieve the value, first without expanding the environment 
        ' variable and then expanding it.
        Console.WriteLine("Unexpanded: ""{0}""", _
            rk.GetValue("ExpandValue", "No Value", _
            RegistryValueOptions.DoNotExpandEnvironmentNames))
        Console.WriteLine("Expanded: ""{0}""", rk.GetValue("ExpandValue"))
    End Sub
End Class

注釈

取得した値の特別な処理を指定するには、このオーバーロードを使用します。Use this overload to specify special processing of the retrieved value. たとえば、 RegistryValueOptions.DoNotExpandEnvironmentNames RegistryValueKind.ExpandString 埋め込み環境変数を展開せずに文字列を取得するために、型のレジストリ値を取得するときにを指定できます。For example, you can specify RegistryValueOptions.DoNotExpandEnvironmentNames when retrieving a registry value of type RegistryValueKind.ExpandString to retrieve the string without expanding embedded environment variables.

パラメーターを使用して defaultValue 、が存在しない場合に返す値を指定し name ます。Use the defaultValue parameter to specify the value to return if name does not exist.

注意

レジストリキーには、どの名前にも関連付けられていない1つの値を含めることができます。A registry key can have one value that is not associated with any name. この名前のない値がレジストリエディターに表示されると、名前の代わりに "(既定値)" という文字列が表示されます。When this unnamed value is displayed in the registry editor, the string "(Default)" appears instead of a name. この無名の値を取得するに null は、に対してまたは空の文字列 ("") を指定し name ます。To retrieve this unnamed value, specify either null or the empty string ("") for name.

GetValue では、REG_NONE または REG_LINK 型の値の読み取りはサポートされていません。GetValue does not support reading values of type REG_NONE or REG_LINK. どちらの場合も、実際の値の代わりに既定値 ( null ) が返されます。In both cases, the default value (null) is returned instead of the actual value.

こちらもご覧ください

適用対象

GetValue(String)

指定した名前に関連付けられている値を取得します。Retrieves the value associated with the specified name. 名前/値ペアがレジストリに存在しない場合、null を返します。Returns null if the name/value pair does not exist in the registry.

public:
 System::Object ^ GetValue(System::String ^ name);
public object GetValue (string name);
public object? GetValue (string? name);
member this.GetValue : string -> obj
Public Function GetValue (name As String) As Object

パラメーター

name
String

取得する値の名前。The name of the value to retrieve. この文字列の大文字と小文字は区別されません。This string is not case-sensitive.

戻り値

Object

name に関連付けられた値。name が見つからない場合は nullThe value associated with name, or null if name is not found.

例外

ユーザーに、レジストリ キーからの読み取りに必要なアクセス許可がありません。The user does not have the permissions required to read from the registry key.

指定された値を格納している RegistryKey が閉じています。閉じられたキーにはアクセスできません。The RegistryKey that contains the specified value is closed (closed keys cannot be accessed).

指定された値を格納する RegistryKey は、削除対象としてマークされています。The RegistryKey that contains the specified value has been marked for deletion.

ユーザーに、必要なレジストリ権限がありません。The user does not have the necessary registry rights.

次のコード例では、テストキーを作成し、異なるデータ型の値をキーに追加します。The following code example creates a test key and adds values of different data types to the key. 次に、名前と値のペアを読み取ってコンソールに表示し、メソッドを使用して GetValueKind 対応するレジストリデータ型を取得します。The example then reads the name/value pairs and displays them to the console, using the GetValueKind method to retrieve the corresponding registry data types.

using namespace System;
using namespace Microsoft::Win32;
int main()
{
   
   // Delete and recreate the test key.
   Registry::CurrentUser->DeleteSubKey( "RegistryValueKindExample", false );
   RegistryKey ^ rk = Registry::CurrentUser->CreateSubKey( "RegistryValueKindExample" );
   
   // Create name/value pairs.
   // This overload supports QWord (long) values. 
   rk->SetValue( "QuadWordValue", 42, RegistryValueKind::QWord );
   
   // The following SetValue calls have the same effect as using the
   // SetValue overload that does not specify RegistryValueKind.
   //
   rk->SetValue( "DWordValue", 42, RegistryValueKind::DWord );
   rk->SetValue( "MultipleStringValue", gcnew array<String^>{
      "One","Two","Three"
   }, RegistryValueKind::MultiString );
   rk->SetValue( "BinaryValue", gcnew array<Byte>{
      10,43,44,45,14,255
   }, RegistryValueKind::Binary );
   rk->SetValue( "StringValue", "The path is %PATH%", RegistryValueKind::String );
   
   // This overload supports setting expandable string values. Compare
   // the output from this value with the previous string value.
   rk->SetValue( "ExpandedStringValue", "The path is %PATH%", RegistryValueKind::ExpandString );
   
   // Display all the name/value pairs stored in the test key, with the
   // registry data type in parentheses.
   //
   array<String^>^valueNames = rk->GetValueNames();
   System::Collections::IEnumerator^ myEnum = valueNames->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum->Current);
      RegistryValueKind rvk = rk->GetValueKind( s );
      switch ( rvk )
      {
         case RegistryValueKind::MultiString:
         {
            array<String^>^values = (array<String^>^)rk->GetValue( s );
            Console::Write( "\r\n {0} ({1}) =", s, rvk );
            for ( int i = 0; i < values->Length; i++ )
            {
               if (i != 0) Console::Write(",");
               Console::Write( " \"{0}\"", values[ i ] );

            }
            Console::WriteLine();
            break;
         }
         case RegistryValueKind::Binary:
         {
            array<Byte>^bytes = (array<Byte>^)rk->GetValue( s );
            Console::Write( "\r\n {0} ({1}) =", s, rvk );
            for ( int i = 0; i < bytes->Length; i++ )
            {
               
               // Display each byte as two hexadecimal digits.
               Console::Write( " {0:X2}", bytes[ i ] );

            }
            Console::WriteLine();
            break;
         }
         default:
            Console::WriteLine( "\r\n {0} ({1}) = {2}", s, rvk, rk->GetValue( s ) );
            break;
      }
   }
}
/*

This code example produces the following output:
 QuadWordValue (QWord) = 42

 DWordValue (DWord) = 42

 MultipleStringValue (MultiString) =, "One", "Two", "Three"

 BinaryValue (Binary) = 0A 2B 2C 2D 0E FF

 StringValue (String) = The path is %PATH%

 ExpandedStringValue (ExpandString) = The path is C:\Program Files\Microsoft.NET\SDK\v2.0\Bin;
 [***The remainder of this output is omitted.***]

*/
using System;
using Microsoft.Win32;

public class Example
{
    public static void Main()
    {
        // Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryValueKindExample", false);
        RegistryKey rk = Registry.CurrentUser.CreateSubKey("RegistryValueKindExample");

        // Create name/value pairs.

        // This overload supports QWord (long) values.
        rk.SetValue("QuadWordValue", 42, RegistryValueKind.QWord);

        // The following SetValue calls have the same effect as using the
        // SetValue overload that does not specify RegistryValueKind.
        //
        rk.SetValue("DWordValue", 42, RegistryValueKind.DWord);
        rk.SetValue("MultipleStringValue", new string[] {"One", "Two", "Three"}, RegistryValueKind.MultiString);
        rk.SetValue("BinaryValue", new byte[] {10, 43, 44, 45, 14, 255}, RegistryValueKind.Binary);
        rk.SetValue("StringValue", "The path is %PATH%", RegistryValueKind.String);

        // This overload supports setting expandable string values. Compare
        // the output from this value with the previous string value.
        rk.SetValue("ExpandedStringValue", "The path is %PATH%", RegistryValueKind.ExpandString);

        // Display all name/value pairs stored in the test key, with each
        // registry data type in parentheses.
        //
        string[] valueNames = rk.GetValueNames();
        foreach (string s in valueNames)
        {
            RegistryValueKind rvk = rk.GetValueKind(s);
            switch (rvk)
            {
                case RegistryValueKind.MultiString :
                    string[] values = (string[]) rk.GetValue(s);
                    Console.Write("\r\n {0} ({1}) =", s, rvk);
                    for (int i = 0; i < values.Length; i++)
                    {
                        if (i != 0) Console.Write(",");
                        Console.Write(" \"{0}\"", values[i]);
                    }
                    Console.WriteLine();
                    break;

                case RegistryValueKind.Binary :
                    byte[] bytes = (byte[]) rk.GetValue(s);
                    Console.Write("\r\n {0} ({1}) =", s, rvk);
                    for (int i = 0; i < bytes.Length; i++)
                    {
                        // Display each byte as two hexadecimal digits.
                        Console.Write(" {0:X2}", bytes[i]);
                    }
                    Console.WriteLine();
                    break;

                default :
                    Console.WriteLine("\r\n {0} ({1}) = {2}", s, rvk, rk.GetValue(s));
                    break;
            }
        }
    }
}
/*

This code example produces the following output:
 QuadWordValue (QWord) = 42

 DWordValue (DWord) = 42

 MultipleStringValue (MultiString) =, "One", "Two", "Three"

 BinaryValue (Binary) = 0A 2B 2C 2D 0E FF

 StringValue (String) = The path is %PATH%

 ExpandedStringValue (ExpandString) = The path is C:\Program Files\Microsoft.NET\SDK\v2.0\Bin;
 [***The remainder of this output is omitted.***]

*/
Imports Microsoft.Win32

Public Class Example
    Public Shared Sub Main()
        ' Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryValueKindExample", False)
        Dim rk As RegistryKey = Registry.CurrentUser.CreateSubKey("RegistryValueKindExample")
        
        ' Create name/value pairs.
        ' This overload supports QWord (long) values. 
        rk.SetValue("QuadWordValue", 42, RegistryValueKind.QWord)
        
        ' The following SetValue calls have the same effect as using the
        ' SetValue overload that does not specify RegistryValueKind.
        '
        rk.SetValue("DWordValue", 42, RegistryValueKind.DWord)
        rk.SetValue("MultipleStringValue", New String() {"One", "Two", "Three"}, RegistryValueKind.MultiString)
        rk.SetValue("BinaryValue", New Byte() {10, 43, 44, 45, 14, 255}, RegistryValueKind.Binary)
        rk.SetValue("StringValue", "The path is %PATH%", RegistryValueKind.String) 
        
        ' This overload supports setting expandable string values. Compare
        ' the output from this value with the previous string value.
        rk.SetValue("ExpandedStringValue", "The path is %PATH%", RegistryValueKind.ExpandString)
        
        
        ' Display all name/value pairs stored in the test key, with each
        ' registry data type in parentheses.
        '
        Dim valueNames As String() = rk.GetValueNames()
        Dim s As String
        For Each s In  valueNames
            Dim rvk As RegistryValueKind = rk.GetValueKind(s)
            Select Case rvk
                Case RegistryValueKind.MultiString
                    Dim values As String() = CType(rk.GetValue(s), String())
                    Console.Write(vbCrLf & " {0} ({1}) =", s, rvk)
                    For i As Integer = 0 To values.Length - 1
                        If i <> 0 Then Console.Write(",")
                        Console.Write(" ""{0}""", values(i))
                    Next i
                    Console.WriteLine()
                
                Case RegistryValueKind.Binary
                    Dim bytes As Byte() = CType(rk.GetValue(s), Byte())
                    Console.Write(vbCrLf & " {0} ({1}) =", s, rvk)
                    For i As Integer = 0 To bytes.Length - 1
                        ' Display each byte as two hexadecimal digits.
                        Console.Write(" {0:X2}", bytes(i))
                    Next i
                    Console.WriteLine()
                
                Case Else
                    Console.WriteLine(vbCrLf & " {0} ({1}) = {2}", s, rvk, rk.GetValue(s))
            End Select
        Next s
    End Sub
End Class

'
'This code example produces the following output (some output is omitted):
'
' QuadWordValue (QWord) = 42
'
' DWordValue (DWord) = 42
'
' MultipleStringValue (MultiString) = "One", "Two", "Three"
'
' BinaryValue (Binary) = 0A 2B 2C 2D 0E FF
'
' StringValue (String) = The path is %PATH%
'
' ExpandedStringValue (ExpandString) = The path is C:\Program Files\Microsoft.NET\SDK\v2.0\Bin;
' [***The remainder of this output is omitted.***]

注釈

注意

レジストリキーには、どの名前にも関連付けられていない1つの値を含めることができます。A registry key can have one value that is not associated with any name. この名前のない値がレジストリエディターに表示されると、名前の代わりに "(既定値)" という文字列が表示されます。When this unnamed value is displayed in the registry editor, the string "(Default)" appears instead of a name. この無名の値を取得するに null は、に対してまたは空の文字列 ("") を指定し name ます。To retrieve this unnamed value, specify either null or the empty string ("") for name.

メソッドが GetValue 展開可能な文字列値 () を取得すると RegistryValueKind.ExpandString 、ローカル環境のデータを使用して環境文字列が展開されます。When the GetValue method retrieves expandable string values (RegistryValueKind.ExpandString), it expands environment strings using data from the local environment. リモートコンピューターのレジストリから展開可能な文字列値を取得するには、メソッドオーバーロードを使用して、 GetValue(String, Object, RegistryValueOptions) 環境文字列を展開しないように指定します。To retrieve expandable string values from the registry on a remote computer, use the GetValue(String, Object, RegistryValueOptions) method overload to specify that you do not want environment strings expanded.

注意

環境変数への展開可能な参照を含む値が、展開可能な文字列 () ではなく文字列 () として格納されている場合 RegistryValueKind.String RegistryValueKind.ExpandString 、で GetValue は展開されません。If a value containing expandable references to environment variables has been stored as a string (RegistryValueKind.String), rather than as an expandable string (RegistryValueKind.ExpandString), GetValue does not expand it. メソッドを呼び出すことにより、このような文字列を取得した後に展開でき ExpandEnvironmentVariables ます。You can expand such a string after it has been retrieved by calling the ExpandEnvironmentVariables method.

注意

キーからデータを取得する PerformanceData 場合は、メソッドではなくクラスを使用することをお勧めし PerformanceCounter RegistryKey.GetValue ます。The recommended way to retrieve data from the PerformanceData key is to use the PerformanceCounter class rather than the RegistryKey.GetValue method.

GetValue では、REG_NONE または REG_LINK 型の値の読み取りはサポートされていません。GetValue does not support reading values of type REG_NONE or REG_LINK. どちらの場合も、実際の値の代わりに既定値 ( null ) が返されます。In both cases, the default value (null) is returned instead of the actual value.

こちらもご覧ください

適用対象

GetValue(String, Object)

指定した名前に関連付けられている値を取得します。Retrieves the value associated with the specified name. 名前が見つからない場合、設定されている既定値を返します。If the name is not found, returns the default value that you provide.

public:
 System::Object ^ GetValue(System::String ^ name, System::Object ^ defaultValue);
public object GetValue (string name, object defaultValue);
public object? GetValue (string? name, object? defaultValue);
member this.GetValue : string * obj -> obj
Public Function GetValue (name As String, defaultValue As Object) As Object

パラメーター

name
String

取得する値の名前。The name of the value to retrieve. この文字列の大文字と小文字は区別されません。This string is not case-sensitive.

defaultValue
Object

name が存在しない場合に返す値。The value to return if name does not exist.

戻り値

Object

name に関連付けられた値 (埋め込まれた環境変数は未展開のまま)。defaultValue が見つからない場合は nameThe value associated with name, with any embedded environment variables left unexpanded, or defaultValue if name is not found.

例外

ユーザーに、レジストリ キーからの読み取りに必要なアクセス許可がありません。The user does not have the permissions required to read from the registry key.

指定された値を格納している RegistryKey が閉じています。閉じられたキーにはアクセスできません。The RegistryKey that contains the specified value is closed (closed keys cannot be accessed).

指定された値を格納する RegistryKey は、削除対象としてマークされています。The RegistryKey that contains the specified value has been marked for deletion.

ユーザーに、必要なレジストリ権限がありません。The user does not have the necessary registry rights.

次のコード例では、値を指定してテストキーを作成し、その値を取得します。The following code example creates a test key with a value and retrieves that value. 次に、この例では、キーから存在しない値を取得しようとします。この場合、メソッドは、 GetValue 指定された既定値を返します。The example then attempts to retrieve a nonexistent value from the key; in this case the GetValue method returns the specified default value.

using namespace System;
using namespace Microsoft::Win32;

public ref class RegGetDef
{
public:
    static void Main()
    {
        // Create a reference to a valid key.  In order for this code to
        // work, the indicated key must have been created previously.
        // The key name is not case-sensitive.
        RegistryKey^ rk = Registry::LocalMachine->OpenSubKey("Software\\myTestKey", false);
        // Get the value from the specified name/value pair in the key.
        String^ valueName = "myTestValue";

        Console::WriteLine("Retrieving registry value ...");
        Console::WriteLine();
        Object^ o = rk->GetValue(valueName);
        Console::WriteLine("Object Type = " + o->GetType()->FullName);
        Console::WriteLine();
        switch (rk->GetValueKind(valueName))
        {
            case RegistryValueKind::String:
            case RegistryValueKind::ExpandString:
                Console::WriteLine("Value = " + o);
                break;
            case RegistryValueKind::Binary:
                for each (Byte^ b in (array<Byte^>^)o)
                {
                    Console::Write("{0:x2} ", b);
                }
                Console::WriteLine();
                break;
            case RegistryValueKind::DWord:
                Console::WriteLine("Value = " + Convert::ToString((Int32^)o));
                break;
            case RegistryValueKind::QWord:
                Console::WriteLine("Value = " + Convert::ToString((Int64^)o));
                break;
            case RegistryValueKind::MultiString:
                for each (String^ s in (array<String^>^)o)
                {
                    Console::Write("[{0:s}], ", s);
                }
                Console::WriteLine();
                break;
            default:
                Console::WriteLine("Value = (Unknown)");
                break;
        }

        // Attempt to retrieve a value that does not exist; the specified
        // default value is returned.
        String^ def = (String^)rk->GetValue("notavalue", "The default to return");
        Console::WriteLine();
        Console::WriteLine(def);
        
        rk->Close();
    }
};

int main()
{
    RegGetDef::Main();
}
/*
Output:
Retrieving registry value ...

Object Type = System.String

Value = testData

The default to return
*/
using System;
using Microsoft.Win32;

class RegGetDef
{
    public static void Main()
    {
        // Create a reference to a valid key.  In order for this code to
        // work, the indicated key must have been created previously.
        // The key name is not case-sensitive.
        RegistryKey rk = Registry.LocalMachine.OpenSubKey("Software\\myTestKey", false);
        // Get the value from the specified name/value pair in the key.

        string valueName = "myTestValue";

        Console.WriteLine("Retrieving registry value ...");
        Console.WriteLine();
        object o = rk.GetValue(valueName);
        Console.WriteLine("Object Type = " + o.GetType().FullName);
        Console.WriteLine();
        switch (rk.GetValueKind(valueName))
        {
            case RegistryValueKind.String:
            case RegistryValueKind.ExpandString:
                Console.WriteLine("Value = " + o);
                break;
            case RegistryValueKind.Binary:
                foreach (byte b in (byte[])o)
                {
                    Console.Write("{0:x2} ", b);
                }
                Console.WriteLine();
                break;
            case RegistryValueKind.DWord:
                Console.WriteLine("Value = " + Convert.ToString((Int32)o));
                break;
            case RegistryValueKind.QWord:
                Console.WriteLine("Value = " + Convert.ToString((Int64)o));
                break;
            case RegistryValueKind.MultiString:
                foreach (string s in (string[])o)
                {
                    Console.Write("[{0:s}], ", s);
                }
                Console.WriteLine();
                break;
            default:
                Console.WriteLine("Value = (Unknown)");
                break;
        }

        // Attempt to retrieve a value that does not exist; the specified
        // default value is returned.
        string def = (string)rk.GetValue("notavalue", "The default to return");
        Console.WriteLine();
        Console.WriteLine(def);

        rk.Close();
    }
}
/*
Output:
Retrieving registry value ...

Object Type = System.String

Value = testData

The default to return
*/
Imports Microsoft.Win32

Public Class RegGetDef
    Public Shared Sub Main()
        ' Create a reference to a valid key.  In order for this code to
        ' work, the indicated key must have been created previously.
        ' The key name is not case-sensitive.
        Dim rk As RegistryKey = Registry.LocalMachine.OpenSubKey("Software\myTestKey", false)

        ' Get the value from the specified name/value pair in the key.
        Dim valueName As String = "myTestValue"

        Console.WriteLine("Retrieving registry value ...")
        Console.WriteLine()
        Dim o As Object = rk.GetValue(valueName)
        Console.WriteLine("Object Type = " + o.GetType().FullName)
        Console.WriteLine()
        Select Case rk.GetValueKind(valueName)
            Case RegistryValueKind.String
            Case RegistryValueKind.ExpandString
                Console.WriteLine("Value = " + o)
            Case RegistryValueKind.Binary
                For Each b As Byte In CType(o,Byte())
                    Console.Write("{0:x2} ", b)
                Next b
                Console.WriteLine()
            Case RegistryValueKind.DWord
                Console.WriteLine("Value = " + Convert.ToString(CType(o,Int32)))
            Case RegistryValueKind.QWord
                Console.WriteLine("Value = " + Convert.ToString(CType(o,Int64)))
            Case RegistryValueKind.MultiString
                For Each s As String In CType(o,String())
                    Console.Write("[{0:s}], ", s)
                Next s
                Console.WriteLine()
            Case Else
                Console.WriteLine("Value = (Unknown)")
        End Select

        ' Attempt to retrieve a value that does not exist; the specified
        ' default value is returned.
        Dim Def As String = rk.GetValue("notavalue", "The default to return")
        Console.WriteLine()
        Console.WriteLine(def)
        
        rk.Close()
    End Sub
End Class
'
' Output:
' Retrieving registry value ...
'
' Object Type = System.String
'
' Value = testData
'
'The default to return

注釈

のこのオーバーロードを使用して、 GetValue 名前がまだ存在しないケース (たとえば、アプリケーションを初めて実行したとき) を処理します。Use this overload of GetValue to handle the case where a name does not exist yet - for example, the first time your application is run. このオーバーロードを呼び出すときは常に、パラメーターを使用して、 defaultValue が存在しない場合に返す値を指定し name ます。Whenever you call this overload, use the defaultValue parameter to specify the value to return if name does not exist.

注意

レジストリキーには、どの名前にも関連付けられていない1つの値を含めることができます。A registry key can have one value that is not associated with any name. この名前のない値がレジストリエディターに表示されると、名前の代わりに "(既定値)" という文字列が表示されます。When this unnamed value is displayed in the registry editor, the string "(Default)" appears instead of a name. この無名の値を取得するに null は、に対してまたは空の文字列 ("") を指定し name ます。To retrieve this unnamed value, specify either null or the empty string ("") for name.

メソッドが GetValue 展開可能な文字列値 () を取得すると RegistryValueKind.ExpandString 、ローカル環境のデータを使用して環境文字列が展開されます。When the GetValue method retrieves expandable string values (RegistryValueKind.ExpandString), it expands environment strings using data from the local environment. リモートコンピューターのレジストリから展開可能な文字列値を取得するには、オーバーロードを使用して、 GetValue 環境文字列を展開しないように指定します。To retrieve expandable string values from the registry on a remote computer, use the GetValue overload to specify that you do not want environment strings expanded.

注意

環境変数への展開可能な参照を含む値が、展開可能な文字列 () ではなく文字列 () として格納されている場合、 RegistryValueKind.String RegistryValueKind.ExpandString メソッドは GetValue 拡張されません。If a value containing expandable references to environment variables has been stored as a string (RegistryValueKind.String), rather than as an expandable string (RegistryValueKind.ExpandString), the GetValue method does not expand it. メソッドを呼び出すことにより、このような文字列を取得した後に展開でき ExpandEnvironmentVariables ます。You can expand such a string after it has been retrieved by calling the ExpandEnvironmentVariables method.

注意

キーからデータを取得する PerformanceData 場合は、メソッドではなくクラスを使用することをお勧めし PerformanceCounter RegistryKey.GetValue ます。The recommended way to retrieve data from the PerformanceData key is to use the PerformanceCounter class rather than the RegistryKey.GetValue method.

GetValue では、REG_NONE または REG_LINK 型の値の読み取りはサポートされていません。GetValue does not support reading values of type REG_NONE or REG_LINK. どちらの場合も、実際の値の代わりに既定値 ( null ) が返されます。In both cases, the default value (null) is returned instead of the actual value.

こちらもご覧ください

適用対象