RegistryKey.DeleteSubKeyTree 메서드

정의

네임스페이스:
Microsoft.Win32
어셈블리:
mscorlib.dll

선택적 예외 처리를 사용하여 하위 키와 자식 하위 키를 재귀적으로 삭제합니다.

오버로드

Name Description
DeleteSubKeyTree(String, Boolean)

지정된 하위 키와 자식 하위 키를 재귀적으로 삭제하고 하위 키를 찾을 수 없는 경우 예외가 발생하는지 여부를 지정합니다.
DeleteSubKeyTree(String)

하위 키와 자식 하위 키를 재귀적으로 삭제합니다.

DeleteSubKeyTree(String, Boolean)

지정된 하위 키와 자식 하위 키를 재귀적으로 삭제하고 하위 키를 찾을 수 없는 경우 예외가 발생하는지 여부를 지정합니다.

public:
 void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);
[System.Runtime.InteropServices.ComVisible(false)]
public void DeleteSubKeyTree(string subkey, bool throwOnMissingSubKey);
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DeleteSubKeyTree : string * bool -> unit
Public Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)

매개 변수

subkey
String

삭제할 하위 키의 이름입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

throwOnMissingSubKey
Boolean

지정된 하위 키를 찾을 수 없는 경우 예외를 발생시켜야 하는지 여부를 나타냅니다. 이 인수가 true 있고 지정된 하위 키가 없으면 예외가 발생합니다. 이 인수가 false 있고 지정된 하위 키가 없으면 아무 작업도 수행되지 않습니다.

특성
ComVisibleAttribute

예외

ArgumentException

트리의 루트 하이브를 삭제하려고 했습니다.

-또는-

subkey 은 유효한 레지스트리 하위 키를 지정하지 않으며 throwOnMissingSubKey ,입니다 true.

ArgumentNullException

subkey은 null입니다.

ObjectDisposedException

RegistryKey 닫혀 있습니다(닫힌 키에 액세스할 수 없음).

UnauthorizedAccessException

사용자에게 필요한 레지스트리 권한이 없습니다.

SecurityException

사용자에게 키를 삭제하는 데 필요한 권한이 없습니다.

적용 대상

DeleteSubKeyTree(String)

하위 키와 자식 하위 키를 재귀적으로 삭제합니다.

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

매개 변수

subkey
String

삭제할 하위 키입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

예외

ArgumentNullException

subkey은 null입니다.

ArgumentException

루트 하이브 삭제가 시도됩니다.

-또는-

subkey 는 유효한 레지스트리 하위 키를 지정하지 않습니다.

IOException

I/O 오류가 발생했습니다.

SecurityException

사용자에게 키를 삭제하는 데 필요한 권한이 없습니다.

ObjectDisposedException

조작 중인 키가 RegistryKey 닫혀 있습니다(닫힌 키에 액세스할 수 없음).

UnauthorizedAccessException

사용자에게 필요한 레지스트리 권한이 없습니다.

예제

이 코드 예제는 클래스에 제공된 더 큰 예제의 RegistryKey 일부입니다.

// Delete or close the new subkey.
Console::Write( "\nDelete newly created registry key? (Y/N) " );
if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y' )
{
   Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
   Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name );
}
else
{
   Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString() );
   test9999->Close();
}

// Delete or close the new subkey.
Console.Write("\nDelete newly created registry key? (Y/N) ");
if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
{
    Registry.CurrentUser.DeleteSubKeyTree("Test9999");
    Console.WriteLine("\nRegistry key {0} deleted.",
        test9999.Name);
}
else
{
    Console.WriteLine("\nRegistry key {0} closed.",
        test9999.ToString());
    test9999.Close();
}

' Delete or close the new subkey.
Console.Write(vbCrLf & "Delete newly created " & _
    "registry key? (Y/N) ")
If Char.ToUpper(Convert.ToChar(Console.Read())) = "Y"C Then
    Registry.CurrentUser.DeleteSubKeyTree("Test9999")
    Console.WriteLine(vbCrLf & "Registry key {0} deleted.", _
        test9999.Name)
Else
    Console.WriteLine(vbCrLf & "Registry key {0} closed.", _
        test9999.ToString())
    test9999.Close()
End If

설명

하위 키와 해당 트리를 삭제하려면 적절한 권한이 있어야 합니다.

Caution

특정 키를 삭제하면 트리의 키 아래에 있는 모든 항목이 제거됩니다. 경고가 제공되지 않습니다. 하위 키가 없는 경우에만 하위 키를 삭제하려면 이 메서드를 DeleteSubKey 사용합니다.

추가 정보

적용 대상