AppDomain.Unload(AppDomain) AppDomain.Unload(AppDomain) AppDomain.Unload(AppDomain) AppDomain.Unload(AppDomain) Method

Definition

Entlädt die angegebene Anwendungsdomäne. Unloads the specified application domain.

public:
 static void Unload(AppDomain ^ domain);
public static void Unload (AppDomain domain);
static member Unload : AppDomain -> unit
Public Shared Sub Unload (domain As AppDomain)

Parameter

domain
AppDomain AppDomain AppDomain AppDomain

Eine zu entladende Anwendungsdomäne. An application domain to unload.

Ausnahmen

Während des Entladeprozesses ist ein Fehler aufgetreten. An error occurred during the unload process.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Anwendungsdomäne entladen wird.The following code example shows how to unload an application domain.

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.");
		}
		
	}
	
}
Imports System
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 'Main 
End Class 'ADUnload

Hinweise

In .NET Framework, Version 2.0 ist ein Thread für das Entladen von Anwendungsdomänen.In the .NET Framework version 2.0 there is a thread dedicated to unloading application domains. Dies verbessert die Zuverlässigkeit, insbesondere bei .NET Framework gehostet wird.This improves reliability, especially when the .NET Framework is hosted. Wenn ein Thread ruft Unload, die Zieldomäne ist für das Entladen markiert.When a thread calls Unload, the target domain is marked for unloading. Der dedizierte Thread versucht, die Domäne zu entladen, und alle Threads in der Domäne werden abgebrochen.The dedicated thread attempts to unload the domain, and all threads in the domain are aborted. Wenn ein Thread nicht, z. B. abgebrochen werden, da sie nicht verwalteten Code ausgeführt wird oder weil es ausgeführt wird ein finally Block nach einiger Zeit eine CannotUnloadAppDomainException wird ausgelöst, in dem Thread, der ursprünglich aufgerufen Unload.If a thread does not abort, for example because it is executing unmanaged code, or because it is executing a finally block, then after a period of time a CannotUnloadAppDomainException is thrown in the thread that originally called Unload. Nach Beendigung des Threads, die letztendlich nicht abgebrochen werden konnte, wird die Zieldomäne nicht entladen.If the thread that could not be aborted eventually ends, the target domain is not unloaded. Also im .NET Framework, Version 2.0 domain nicht notwendigerweise zu entladen, da es möglicherweise nicht möglich, die Ausführung von Threads zu beenden.Thus, in the .NET Framework version 2.0 domain is not guaranteed to unload, because it might not be possible to terminate executing threads.

Hinweis

In einigen Fällen Aufrufen Unload bewirkt, dass eine sofortige CannotUnloadAppDomainException, z. B. Wenn sie in einem Finalizer aufgerufen wird.In some cases, calling Unload causes an immediate CannotUnloadAppDomainException, for example if it is called in a finalizer.

Threads in domain werden beendet, mit der Abort -Methode, die löst eine ThreadAbortException im Thread.The threads in domain are terminated using the Abort method, which throws a ThreadAbortException in the thread. Obwohl der Thread sofort beendet werden soll, es ausführen fortsetzen, unvorhersehbar Zeit in einer finally Klausel.Although the thread should terminate promptly, it can continue executing for an unpredictable amount of time in a finally clause.

VersionskompatibilitätVersion Compatibility

In .NET Framework, Version 1.0 und 1.1, wenn der Thread aufruft Unload läuft in domain, einem anderen Thread zum Ausführen des Entladevorgangs gestartet wird.In the .NET Framework version 1.0 and 1.1 if the thread that calls Unload is running in domain, another thread is started to perform the unload operation. Wenn domain kann nicht entladen werden kann, eine CannotUnloadAppDomainException wird ausgelöst, in diesem Thread, nicht in der ursprüngliche Thread, der aufgerufen Unload.If domain cannot be unloaded, a CannotUnloadAppDomainException is thrown in that thread, not in the original thread that called Unload. Jedoch, wenn der Thread aufruft Unload ausgeführt wird, außerhalb domain, dass der Thread die Ausnahme empfängt.However, if the thread that calls Unload is running outside domain, that thread receives the exception.

Sicherheit

SecurityPermission
Um einen Ereignishandler für dieses Ereignis hinzuzufügen. to add an event handler for this event. Zugeordnete Enumeration: ControlAppDomain Associated enumeration: ControlAppDomain. Sicherheitsaktion: Demand. Security action: Demand.

Gilt für: