RegistryKey.GetValue RegistryKey.GetValue RegistryKey.GetValue RegistryKey.GetValue Method

定義

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

オーバーロード

GetValue(String, Object, RegistryValueOptions) GetValue(String, Object, RegistryValueOptions) GetValue(String, Object, RegistryValueOptions) 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) GetValue(String) GetValue(String) 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) GetValue(String, Object) GetValue(String, Object) 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) GetValue(String, Object, RegistryValueOptions) GetValue(String, Object, RegistryValueOptions) 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);
[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
Public Function GetValue (name As String, defaultValue As Object, options As RegistryValueOptions) As Object

パラメーター

name
String String String String

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

defaultValue
Object Object Object Object

場合に返す値name存在しません。The value to return if name does not exist.

options
RegistryValueOptions RegistryValueOptions RegistryValueOptions RegistryValueOptions

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

戻り値

関連付けられている値name、指定に従って処理され、 options、またはdefaultValue場合nameが見つかりません。The 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 System
Imports Microsoft.Win32
Imports Microsoft.VisualBasic

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 'Main
End Class 'Example

注釈

このオーバー ロードを使用すると、取得した値の特別な処理を指定します。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.

セキュリティ

RegistryPermission
レジストリから読み取る。to read from the registry. 関連付けられた列挙体。 ReadAssociated enumeration: Read

EnvironmentPermission
REG_EXPAND_SZ の種類のレジストリ キーの読み取り。to read a registry key of type REG_EXPAND_SZ. 関連付けられた列挙体。 UnrestrictedAssociated enumeration: Unrestricted

こちらもご覧ください

GetValue(String) GetValue(String) GetValue(String) 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);
member this.GetValue : string -> obj
Public Function GetValue (name As String) As Object

パラメーター

name
String String String String

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

戻り値

関連付けられている値name、またはnull場合nameが見つかりません。The 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 System
Imports Microsoft.Win32
Imports Microsoft.VisualBasic

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 'Main
End Class 'Example

'
'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.

セキュリティ

RegistryPermission
レジストリから読み取る。to read from the registry. 関連付けられた列挙体。 ReadAssociated enumeration: Read

EnvironmentPermission
REG_EXPAND_SZ の種類のレジストリ キーの読み取り。to read a registry key of type REG_EXPAND_SZ. 関連付けられた列挙体。 UnrestrictedAssociated enumeration: Unrestricted

こちらもご覧ください

GetValue(String, Object) GetValue(String, Object) GetValue(String, Object) 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);
member this.GetValue : string * obj -> obj
Public Function GetValue (name As String, defaultValue As Object) As Object

パラメーター

name
String String String String

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

defaultValue
Object Object Object Object

場合に返す値name存在しません。The value to return if name does not exist.

戻り値

関連付けられている値name、いずれかでの埋め込み左未展開、環境変数またはdefaultValue場合nameが見つかりません。The 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 System
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.

セキュリティ

RegistryPermission
レジストリから読み取る。to read from the registry. 関連付けられた列挙体。 ReadAssociated enumeration: Read

EnvironmentPermission
REG_EXPAND_SZ の種類のレジストリ キーの読み取り。to read a registry key of type REG_EXPAND_SZ. 関連付けられた列挙体。 UnrestrictedAssociated enumeration: Unrestricted

こちらもご覧ください

適用対象