AppDomain.Unload(AppDomain) メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: AppDomain.cs

ソース:: AppDomain.cs

ソース:: AppDomain.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

注意事項

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

指定したアプリケーションドメインをアンロードします。

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)

パラメーター

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

こちらもご覧ください

.NET Core/5 以降で使用できないテクノロジ: アプリケーションドメイン

次の方法で共有

AppDomain.Unload(AppDomain) メソッド

定義

パラメーター

例外

例

注釈

適用対象

こちらもご覧ください

その他のリソース