RegistryKey.DeleteValue 메서드

정의

네임스페이스:

Microsoft.Win32

어셈블리:

Microsoft.Win32.Registry.dll

이 키에서 지정된 값을 삭제하고 값이 없으면 예외를 throw합니다.

오버로드

DeleteValue(String)	지정된 값을 이 키에서 삭제합니다.
DeleteValue(String, Boolean)	이 키에서 지정된 값을 삭제하고 값이 없을 경우 예외를 발생시킬지 여부를 지정합니다.

DeleteValue(String)

지정된 값을 이 키에서 삭제합니다.

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

추가 정보

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount

DeleteValue(String, Boolean)

이 키에서 지정된 값을 삭제하고 값이 없을 경우 예외를 발생시킬지 여부를 지정합니다.

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가 읽기 전용인 경우

설명

이 이false면 throwOnMissingValue 삭제된 값에 액세스하려고 시도하지 않고 삭제가 성공했는지 알 수 있는 방법이 없습니다. 따라서 이러한 방식으로 레지스트리에서 값을 삭제할 때는 주의해야 합니다.

추가 정보

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount