AppDomain.Unload(AppDomain) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

AppDomain.cs

Precaución

Creating and unloading AppDomains is not supported and throws an exception.

Descarga el dominio de aplicación especificado.

public:
 static void Unload(AppDomain ^ domain);

[System.Obsolete("Creating and unloading AppDomains is not supported and throws an exception.", DiagnosticId="SYSLIB0024", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static void Unload (AppDomain domain);

[<System.Obsolete("Creating and unloading AppDomains is not supported and throws an exception.", DiagnosticId="SYSLIB0024", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Unload : AppDomain -> unit

Public Shared Sub Unload (domain As AppDomain)

Parámetros

domain

AppDomain

Dominio de aplicación que se va a descargar.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

domain es null.

CannotUnloadAppDomainException

.NET Core y .NET 5+ solo: En todos los casos.

O bien

No se pudo descargar domain.

Exception

Error durante el proceso de descarga.

Ejemplos

En el ejemplo de código siguiente se muestra cómo descargar un dominio de aplicación.

using namespace System;
using namespace System::Reflection;
using namespace System::Security::Policy;

//for evidence Object*
int main()
{
   
   //Create evidence for the new appdomain.
   Evidence^ adevidence = AppDomain::CurrentDomain->Evidence;
   
   // Create the new application domain.
   AppDomain^ domain = AppDomain::CreateDomain( "MyDomain", adevidence );
   Console::WriteLine( "Host domain: {0}", AppDomain::CurrentDomain->FriendlyName );
   Console::WriteLine( "child domain: {0}", domain->FriendlyName );
   
   // Unload the application domain.
   AppDomain::Unload( domain );
   try
   {
      Console::WriteLine();
      
      // Note that the following statement creates an exception because the domain no longer exists.
      Console::WriteLine( "child domain: {0}", domain->FriendlyName );
   }
   catch ( AppDomainUnloadedException^ /*e*/ ) 
   {
      Console::WriteLine( "The appdomain MyDomain does not exist." );
   }

}

using System;
using System.Reflection;
using System.Security.Policy;
class ADUnload
{
    public static void Main()
    {

        //Create evidence for the new appdomain.
        Evidence adevidence = AppDomain.CurrentDomain.Evidence;

        // Create the new application domain.
        AppDomain domain = AppDomain.CreateDomain("MyDomain", adevidence);

                Console.WriteLine("Host domain: " + AppDomain.CurrentDomain.FriendlyName);
                Console.WriteLine("child domain: " + domain.FriendlyName);
        // Unload the application domain.
        AppDomain.Unload(domain);

        try
        {
        Console.WriteLine();
        // Note that the following statement creates an exception because the domain no longer exists.
                Console.WriteLine("child domain: " + domain.FriendlyName);
        }

        catch (AppDomainUnloadedException e)
        {
        Console.WriteLine("The appdomain MyDomain does not exist.");
        }
    }
}

open System

//Create evidence for the new appdomain.
let adevidence = AppDomain.CurrentDomain.Evidence

// Create the new application domain.
let domain = AppDomain.CreateDomain("MyDomain", adevidence)

printfn $"Host domain: {AppDomain.CurrentDomain.FriendlyName}"
printfn $"child domain: {domain.FriendlyName}"
// Unload the application domain.
AppDomain.Unload domain

try
    printfn ""
    // Note that the following statement creates an exception because the domain no longer exists.
    printfn $"child domain: {domain.FriendlyName}"

with :? AppDomainUnloadedException ->
    printfn "The appdomain MyDomain does not exist."

Imports System.Reflection
Imports System.Security.Policy

Class ADUnload
   
   Public Shared Sub Main()

      'Create evidence for the new appdomain.
      Dim adevidence As Evidence = AppDomain.CurrentDomain.Evidence

      ' Create the new application domain.
      Dim domain As AppDomain = AppDomain.CreateDomain("MyDomain", adevidence)
      
      Console.WriteLine(("Host domain: " + AppDomain.CurrentDomain.FriendlyName))
      Console.WriteLine(("child domain: " + domain.FriendlyName))
      ' Unload the application domain.
      AppDomain.Unload(domain)
      
      Try
         Console.WriteLine()
         ' Note that the following statement creates an exception because the domain no longer exists.
         Console.WriteLine(("child domain: " + domain.FriendlyName))
      
      Catch e As AppDomainUnloadedException
         Console.WriteLine("The appdomain MyDomain does not exist.")
      End Try
   End Sub
End Class

Comentarios

En .NET Framework versión 2.0 y posteriores, hay un subproceso dedicado a descargar dominios de aplicación. Esto mejora la confiabilidad, especialmente cuando se hospeda .NET Framework. Cuando un subproceso llama a Unload, el dominio de destino se marca para su descarga. El subproceso dedicado intenta descargar el dominio y se anulan todos los subprocesos del dominio. Si un subproceso no anula, por ejemplo, porque ejecuta código no administrado o porque ejecuta un finally bloque, después de un período de tiempo, se produce un CannotUnloadAppDomainException elemento en el subproceso que originalmente llamó a Unload. Si el subproceso que no se pudo anular finaliza finalmente, el dominio de destino no se descarga. Por lo tanto, en .NET Framework versión 2.0 y posteriores, domain no se garantiza la descarga, ya que es posible que no sea posible finalizar la ejecución de subprocesos.

Nota

En algunos casos, llamar a Unload provoca un inmediato CannotUnloadAppDomainException, por ejemplo, si se llama a en un finalizador.

Los subprocesos de domain se finalizan mediante el Abort método , que produce un ThreadAbortException elemento en el subproceso. Aunque el subproceso debe finalizar rápidamente, puede continuar ejecutándose durante una cantidad impredecible de tiempo en una finally cláusula .

Consulte también

• Tecnologías no disponibles en .NET Core/5+: Dominios de aplicación