Export (0) Print
Expand All

ApplicationActivator Class

Provides the base class for the activation of manifest-based assemblies.

System.Object
  System.Runtime.Hosting.ApplicationActivator

Namespace:  System.Runtime.Hosting
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
<ComVisibleAttribute(True)> _
Public Class ApplicationActivator

The ApplicationActivator type exposes the following members.

  NameDescription
Public methodApplicationActivatorInitializes a new instance of the ApplicationActivator class.
Top

  NameDescription
Public methodCreateInstance(ActivationContext)Creates an instance of the application to be activated, using the specified activation context.
Public methodCreateInstance(ActivationContext, String())Creates an instance of the application to be activated, using the specified activation context and custom activation data.
Protected methodStatic memberCreateInstanceHelperCreates an instance of an application using the specified AppDomainSetup object.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

There is a single designated instance of the ApplicationActivator class in each AppDomain to which all activation calls are routed. The AppDomainManager for the current AppDomain can provide its own custom ApplicationActivator for this purpose. If a custom ApplicationActivator is not provided, an instance of the default ApplicationActivator is created.

The following steps describe the behavior of the default CreateInstance method implementation:

  1. Checks if the ActivationContext of the add-in to be activated matches the ActivationContext of the current domain; if not, proceeds to step 2. Otherwise, executes the assembly and returns the result wrapped in an object handle.

  2. Activates the add-in in a new AppDomain. The following steps are taken to initialize a new AppDomain using the ActivationArguments for the add-in.

    1. Creates a new AppDomainSetup object using an ActivationArguments object containing the activation context for the add-in.

    2. Calls the CreateInstanceHelper method to create a new domain using the AppDomainSetup object.

    3. The CreateInstanceHelper method calls the HostSecurityManager.DetermineApplicationTrust method to acquire an ApplicationTrust object for the add-in. If the IsApplicationTrustedToRun property returns true, the add-in is executed. If not, CreateInstanceHelper throws a PolicyException indicating that execution permission could not be acquired.

    4. If the add-in is trusted to run, then a new AppDomain is created and configured for the ActivationContext of the add-in, and the add-in is loaded and executed.

    5. The result of the activation of the add-in is returned, wrapped in an object handle.

A custom activator can tailor the activation of an add-in to a particular set of circumstances. For example, a custom activator could find an existing AppDomain to activate this add-in instead of creating a new domain every time.

The following steps describe the behavior of a custom ApplicationActivator that activates an add-in in an existing AppDomain:

  1. The custom activator finds a domain that has the same ActivationContext as the add-in that is being activated.

  2. If the ActivationContext has never been seen before in the process, the custom activator creates a new AppDomain for this ActivationContext by calling the CreateDomain method directly, or delegating this activity to the CreateInstanceHelper in the base class.

  3. If there is an existing domain with the same ActivationContext, then the activator can delegate the CreateInstance method call to the ApplicationActivator in the target domain. Note that this would be a cross-domain call to an ApplicationActivator that resides in the target AppDomain.

The following code example shows how to obtain an ApplicationActivator object from the current DomainManager for a manifest-based application.

Imports System
Imports System.Collections
Imports System.Text
Imports System.Security.Policy
Imports System.Reflection
Imports System.Security
Imports System.Security.Permissions
Imports System.Runtime.Hosting



Public Class Program
    Inherits MarshalByRefObject

    <SecurityPermission(SecurityAction.LinkDemand, ControlDomainPolicy:=True)> _
    Public Shared Sub Main(ByVal args() As String)
        ' Get the AppDomainManager from the current domain. 
        Dim domainMgr As AppDomainManager = AppDomain.CurrentDomain.DomainManager
        ' Get the ApplicationActivator from the AppDomainManager. 
        Dim appActivator As ApplicationActivator = domainMgr.ApplicationActivator
        Console.WriteLine("Assembly qualified name from the application activator.")
        Console.WriteLine(appActivator.GetType().AssemblyQualifiedName)
        Dim ac As ActivationContext = AppDomain.CurrentDomain.ActivationContext
        ' Get the ActivationArguments from the SetupInformation property of the domain. 
        Dim activationArgs As ActivationArguments = AppDomain.CurrentDomain.SetupInformation.ActivationArguments
        ' Get the ActivationContext from the ActivationArguments. 
        Dim actContext As ActivationContext = activationArgs.ActivationContext
        Console.WriteLine("The ActivationContext.Form property value is: " + _
         activationArgs.ActivationContext.Form.ToString())
        Console.Read()

    End Sub 'Main

    <SecurityPermission(SecurityAction.LinkDemand, ControlDomainPolicy:=True)> _
    Public Sub Run()
        Main(New String() {})
        Console.ReadLine()

    End Sub 'Run
End Class 'Program

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft