RegistryKey.DeleteSubKeyTree Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Elimina uma subchave e quaisquer subchaves filhas recursivamente, com tratamento opcional de exceções.
Sobrecargas
| Name | Description |
|---|---|
| DeleteSubKeyTree(String, Boolean) |
Elimina recursivamente a subchave especificada e quaisquer subchaves filhas, e especifica se existe uma exceção caso a subchave não seja encontrada. |
| DeleteSubKeyTree(String) |
Apaga uma subchave e quaisquer subchaves filhas recursivamente. |
DeleteSubKeyTree(String, Boolean)
Elimina recursivamente a subchave especificada e quaisquer subchaves filhas, e especifica se existe uma exceção caso a subchave não seja encontrada.
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 -> unitPublic Sub DeleteSubKeyTree (subkey As String, throwOnMissingSubKey As Boolean)Parâmetros
- subkey
- String
O nome da subchave a apagar. Esta cadeia não é sensível a maiúsculas minúsculas.
- throwOnMissingSubKey
- Boolean
Indica se deve ser criada uma exceção caso a subchave especificada não seja encontrada. Se este argumento for true e a subchave especificada não existir, é levantada uma exceção. Se este argumento for false e a subchave especificada não existir, não é tomada qualquer ação.
- Atributos
Exceções
Foi feita uma tentativa de eliminar a colmeia de raízes da árvore.
-ou-
subkey não especifica uma subchave válida do registo, e throwOnMissingSubKey é true.
subkey é null.
O RegistryKey é fechado (as chaves fechadas não podem ser acedidas).
O utilizador não tem os direitos necessários no registo.
O utilizador não tem as permissões necessárias para eliminar a chave.
Aplica-se a
DeleteSubKeyTree(String)
Apaga uma subchave e quaisquer subchaves filhas recursivamente.
public:
void DeleteSubKeyTree(System::String ^ subkey);public void DeleteSubKeyTree(string subkey);member this.DeleteSubKeyTree : string -> unitPublic Sub DeleteSubKeyTree (subkey As String)Parâmetros
- subkey
- String
A subchave a apagar. Esta cadeia não é sensível a maiúsculas minúsculas.
Exceções
subkey é null.
Tenta-se eliminar uma colmeia de raízes.
-ou-
subkey não especifica uma subchave válida do registo.
Ocorreu um erro de E/S.
O utilizador não tem as permissões necessárias para eliminar a chave.
O RegistryKey ser manipulado é fechado (as chaves fechadas não podem ser acedidas).
O utilizador não tem os direitos necessários no registo.
Exemplos
Este exemplo de código faz parte de um exemplo maior fornecido para a RegistryKey classe.
// 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
Observações
Deve ter as permissões adequadas para eliminar a subchave e a sua árvore.
Atenção
Eliminar uma determinada chave remove todas as entradas abaixo da chave na árvore. Não será dado qualquer aviso. Se quiser eliminar uma subchave apenas quando não tem subchaves filhas, use o DeleteSubKey método.