다음을 통해 공유


RegistryKey.DeleteSubKeyTree 메서드

정의

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

오버로드

DeleteSubKeyTree(String, Boolean)

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

DeleteSubKeyTree(String)

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

DeleteSubKeyTree(String, Boolean)

Source:
RegistryKey.cs

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

public:
 void DeleteSubKeyTree(System::String ^ subkey, bool throwOnMissingSubKey);
public void DeleteSubKeyTree (string subkey, bool throwOnMissingSubKey);
[System.Runtime.InteropServices.ComVisible(false)]
public void DeleteSubKeyTree (string subkey, bool throwOnMissingSubKey);
member this.DeleteSubKeyTree : string * bool -> unit
[<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이고 지정된 하위 키가 없으면 아무 작업도 수행되지 않습니다.

특성

예외

트리의 루트 하이브를 삭제하려고 한 경우

또는

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

subkey이(가) null인 경우

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

사용자에게 필요한 레지스트리 권한이 없는 경우

사용자에게 키를 삭제하는 데 필요한 권한이 없는 경우

적용 대상

DeleteSubKeyTree(String)

Source:
RegistryKey.cs

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

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

매개 변수

subkey
String

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

예외

subkey이(가) null인 경우

루트 하이브를 삭제하려고 한 경우

또는

subkey에 유효한 레지스트리 하위 키가 지정되지 않은 경우

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

사용자에게 키를 삭제하는 데 필요한 권한이 없는 경우

조작할 RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

사용자에게 필요한 레지스트리 권한이 없는 경우

예제

이 코드 예제는에 대해 제공 된 큰 예제의 일부는 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 사용합니다.

추가 정보

적용 대상