RegistryKey.DeleteSubKeyTree 메서드

정의

네임스페이스:

Microsoft.Win32

어셈블리:

Microsoft.Win32.Registry.dll

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

오버로드

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

DeleteSubKeyTree(String, Boolean)

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

public:
 void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);

public void DeleteSubKeyTree (string subkey, bool throwOnMissingSubKey);

member this.DeleteSubKeyTree : string * bool -> unit

Public Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)

매개 변수

subkey

String

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

throwOnMissingSubKey

Boolean

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

예외

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

설명

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

주의

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

추가 정보

• DeleteSubKey(String)
• CreateSubKey(String)
• DeleteValue(String)
• GetSubKeyNames()
• SubKeyCount