RegistryKey.DeleteValue 메서드

정의

네임스페이스:: Microsoft.Win32

어셈블리:: mscorlib.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

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

추가 정보

적용 대상

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입니다.