AppDomain.Unload(AppDomain) Méthode

Référence

Définition

Espace de noms:: System

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: AppDomain.cs

Source:: AppDomain.cs

Source:: AppDomain.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Attention

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

Décharge le domaine d'application spécifié.

public:
 static void Unload(AppDomain ^ domain);

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);

static member Unload : AppDomain -> unit

[<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)

Paramètres

domain: AppDomain

Domaine d'application à décharger.

Attributs: ObsoleteAttribute

Exceptions

ArgumentNullException

domain a la valeur null.

CannotUnloadAppDomainException

.NET Core et .NET 5 (et versions ultérieures) uniquement : Dans tous les cas.

-ou-

Le domain n'a pas pu être déchargé.

Exception

Une erreur s'est produite pendant le processus de déchargement.

Exemples

L’exemple de code suivant montre comment décharger un domaine d’application.

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

Remarques

Dans .NET Framework version 2.0 et ultérieures, il existe un thread dédié au déchargement des domaines d’application. Cela améliore la fiabilité, en particulier lorsque .NET Framework est hébergé. Lorsqu’un thread appelle Unload, le domaine cible est marqué pour le déchargement. Le thread dédié tente de décharger le domaine et tous les threads du domaine sont abandonnés. Si un thread n’abandonne pas, par exemple parce qu’il exécute du code non managé ou parce qu’il exécute un finally bloc, après un certain temps, un CannotUnloadAppDomainException est levée dans le thread qui a initialement appelé Unload. Si le thread qui n’a pas pu être abandonné se termine, le domaine cible n’est pas déchargé. Par conséquent, dans .NET Framework version 2.0 et ultérieure, le déchargement n’est pas garanti, domain car il n’est peut-être pas possible d’arrêter l’exécution des threads.

Remarque

Dans certains cas, l’appel Unload entraîne un effet immédiat CannotUnloadAppDomainException, par exemple s’il est appelé dans un finaliseur.

Les threads dans domain sont arrêtés à l’aide de la Abort méthode, qui lève un ThreadAbortException dans le thread. Bien que le thread se termine rapidement, il peut continuer à s’exécuter pendant un laps de temps imprévisible dans une finally clause.

S’applique à

Produit	Versions (Obsolète)
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5 (6, 7, 8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Voir aussi

Technologies non disponibles sur .NET Core/5+ : Domaines d’application

Partage via