RegistryKey.DeleteValue メソッド

定義

名前空間:
Microsoft.Win32
アセンブリ:
Microsoft.Win32.Registry.dll
アセンブリ:
mscorlib.dll
パッケージ:
Microsoft.Win32.Registry v5.0.0

このキーから指定した値を削除し、値が見つからない場合は例外をスローします。

オーバーロード

名前 説明
DeleteValue(String)

指定した値をこのキーから削除します。
DeleteValue(String, Boolean)

このキーから指定した値を削除し、値が見つからない場合に例外が発生するかどうかを指定します。

DeleteValue(String)

ソース:
RegistryKey.cs

指定した値をこのキーから削除します。

public:
 void DeleteValue(System::String ^ name);
public void DeleteValue(string name);
member this.DeleteValue : string -> unit
Public Sub DeleteValue (name As String)

パラメーター

name
String

削除する値の名前。

例外

ArgumentException

name は値への有効な参照ではありません。

SecurityException

ユーザーには、値を削除するために必要なアクセス許可がありません。

ObjectDisposedException

操作されている RegistryKey は閉じられています (閉じたキーにはアクセスできません)。

UnauthorizedAccessException

操作される RegistryKey は読み取り専用です。

例

このコード例は、 RegistryKey クラスに提供されるより大きな例の一部です。

// Delete the ID value.
testSettings = test9999->OpenSubKey( "TestSettings", true );
testSettings->DeleteValue( "id" );

// Verify the deletion.
Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue(  "id", "ID not found." )) );
testSettings->Close();

using(RegistryKey
    testSettings = test9999.OpenSubKey("TestSettings", true))
{
    // Delete the ID value.
    testSettings.DeleteValue("id");

    // Verify the deletion.
    Console.WriteLine((string)testSettings.GetValue(
        "id", "ID not found."));
}

' Delete the ID value.
testSettings = test9999.OpenSubKey("TestSettings", True)
testSettings.DeleteValue("id")

' Verify the deletion.
Console.WriteLine(CType(testSettings.GetValue( _
    "id", "ID not found."), String))
testSettings.Close()

こちらもご覧ください

適用対象

DeleteValue(String, Boolean)

ソース:
RegistryKey.cs

このキーから指定した値を削除し、値が見つからない場合に例外が発生するかどうかを指定します。

public:
 void DeleteValue(System::String ^ name, bool throwOnMissingValue);
public void DeleteValue(string name, bool throwOnMissingValue);
member this.DeleteValue : string * bool -> unit
Public Sub DeleteValue (name As String, throwOnMissingValue As Boolean)

パラメーター

name
String

削除する値の名前。

throwOnMissingValue
Boolean

指定した値が見つからない場合に例外を発生させるかどうかを示します。 この引数が true され、指定した値が存在しない場合は、例外が発生します。 この引数が false され、指定した値が存在しない場合、アクションは実行されません。

例外

ArgumentException

name は値への有効な参照ではなく、 throwOnMissingValue が true。

-又は-

name は nullです。

SecurityException

ユーザーには、値を削除するために必要なアクセス許可がありません。

ObjectDisposedException

操作されている RegistryKey は閉じられています (閉じたキーにはアクセスできません)。

UnauthorizedAccessException

操作される RegistryKey は読み取り専用です。

注釈

throwOnMissingValueがfalseされている場合、削除された値にアクセスせずに削除が成功したかどうかを確認する方法はありません。 そのため、この方法でレジストリから値を削除するときは注意が必要です。

こちらもご覧ください

適用対象