AppDomain.Unload(AppDomain) Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

AppDomain.cs

Внимание!

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

Выгружает заданный домен приложения.

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)

Параметры

domain

AppDomain

Домен приложения, который нужно выгрузить.

Атрибуты

ObsoleteAttribute

Исключения

ArgumentNullException

domain имеет значение null.

CannotUnloadAppDomainException

Только .NET Core и .NET 5+: Во всех случаях.

-или-

Домен, определенный параметром domain, не может быть выгружен.

Exception

Во время выполнения выгрузки произошла ошибка.

Примеры

В следующем примере кода показано, как выгрузить домен приложения.

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

Комментарии

В платформа .NET Framework версии 2.0 и более поздних существует поток, предназначенный для выгрузки доменов приложений. Это повышает надежность, особенно при размещении платформа .NET Framework. Когда поток вызывает Unload, целевой домен помечается для выгрузки. Выделенный поток пытается выгрузить домен, и все потоки в домене прерываются. Если поток не прерывается, например из-за того, что он выполняет неуправляемый код или потому, что он выполняет finally блок, через некоторое время в потоке, CannotUnloadAppDomainException который первоначально назывался Unload. Если поток, который не удалось прервать, в конечном итоге завершается, целевой домен не выгружается. Таким образом, в платформа .NET Framework версии 2.0 и более поздних domain не гарантируется выгрузка, так как может быть невозможно завершить выполнение потоков.

Примечание

В некоторых случаях вызов Unload вызывает немедленный CannotUnloadAppDomainExceptionвызов , например, если он вызывается в методе завершения.

Потоки в domain завершаются с помощью Abort метода , который вызывает ThreadAbortException в потоке . Хотя поток должен быстро завершиться, он может продолжать выполнение в течение непредсказуемого количества времени в предложении finally .

См. также раздел

• Недоступные технологии в .NET Core/5+: домены приложений