ApplicationActivator Klas

Definitie

public ref class ApplicationActivator

[System.Runtime.InteropServices.ComVisible(true)]
public class ApplicationActivator

[<System.Runtime.InteropServices.ComVisible(true)>]
type ApplicationActivator = class

Public Class ApplicationActivator

Overname

Object

ApplicationActivator

Kenmerken

ComVisibleAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een ApplicationActivator object ophaalt uit de huidige DomainManager versie voor een toepassing op basis van een manifest.

using System;
using System.Collections;
using System.Text;
using System.Security.Policy;
using System.Reflection;
using System.Security;
using System.Runtime.Hosting;

namespace ActivationContextSample
{
    public class Program : MarshalByRefObject
    {
        public static void Main(string[] args)
        {
            // Get the AppDomainManager from the current domain.
            AppDomainManager domainMgr = AppDomain.CurrentDomain.DomainManager;
            // Get the ApplicationActivator from the AppDomainManager.
            ApplicationActivator appActivator = domainMgr.ApplicationActivator;
            Console.WriteLine("Assembly qualified name from the application activator.");
            Console.WriteLine(appActivator.GetType().AssemblyQualifiedName);
            // Get the ActivationArguments from the SetupInformation property of the domain.
            ActivationArguments activationArgs = AppDomain.CurrentDomain.SetupInformation.ActivationArguments;
            // Get the ActivationContext from the ActivationArguments.
            ActivationContext actContext = activationArgs.ActivationContext;
            Console.WriteLine("The ActivationContext.Form property value is: " +
                activationArgs.ActivationContext.Form);
            Console.Read();
        }
    
        public void Run()
        {
            Main(new string[] { });
            Console.ReadLine();
        }
    }
}

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

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

    End Sub
End Class

Opmerkingen

Er is één aangewezen instantie van de ApplicationActivator klasse waarin AppDomain alle activeringsoproepen worden gerouteerd. De AppDomainManager voor de huidige AppDomain kan hiervoor een eigen aangepaste ApplicationActivator functie bieden. Als er geen aangepaste ApplicationActivator gegevens worden opgegeven, wordt er een exemplaar van de standaardwaarde ApplicationActivator gemaakt.

In de volgende stappen wordt het gedrag van de standaardmethode-implementatie CreateInstance beschreven:

1. Controleert of de ActivationContext invoegtoepassing die moet worden geactiveerd overeenkomt met het ActivationContext huidige domein. Zo niet, gaat u verder met stap 2. Anders wordt de assembly uitgevoerd en wordt het resultaat geretourneerd dat in een objectgreep is verpakt.

2. Hiermee activeert u de invoegtoepassing in een nieuwe AppDomain. De volgende stappen worden uitgevoerd om een nieuw AppDomain exemplaar te initialiseren met behulp van de ActivationArguments invoegtoepassing.

   1. Hiermee maakt u een nieuw AppDomainSetup object met behulp van een ActivationArguments object met de activeringscontext voor de invoegtoepassing.

   2. Roept de CreateInstanceHelper methode aan om een nieuw domein te maken met behulp van het AppDomainSetup object.

   3. Met CreateInstanceHelper de methode wordt de HostSecurityManager.DetermineApplicationTrust methode aangeroepen om een ApplicationTrust object voor de invoegtoepassing te verkrijgen. Als de IsApplicationTrustedToRun eigenschap wordt geretourneerd true, wordt de invoegtoepassing uitgevoerd. Als dat niet het gevolg is, CreateInstanceHelper wordt er een PolicyException melding weergegeven dat de uitvoeringsmachtiging niet kan worden verkregen.

   4. Als de invoegtoepassing wordt vertrouwd om uit te voeren, wordt er een nieuwe AppDomain gemaakt en geconfigureerd voor de ActivationContext invoegtoepassing en wordt de invoegtoepassing geladen en uitgevoerd.

   5. Het resultaat van de activering van de invoegtoepassing wordt geretourneerd, verpakt in een objectgreep.

Een aangepaste activator kan de activering van een invoegtoepassing aanpassen aan een bepaalde set omstandigheden. Een aangepaste activator kan bijvoorbeeld een bestaande AppDomain vinden om deze invoegtoepassing te activeren in plaats van elke keer een nieuw domein te maken.

In de volgende stappen wordt het gedrag beschreven van een aangepaste ApplicationActivator invoegtoepassing die een bestaande AppDomaininvoegtoepassing activeert:

1. De aangepaste activator zoekt een domein met hetzelfde ActivationContext domein als de invoegtoepassing die wordt geactiveerd.

2. Als de ActivationContext methode nog nooit eerder in het proces is gezien, maakt de aangepaste activator hiervoor een nieuwe AppDomainActivationContext door de CreateDomain methode rechtstreeks aan te roepen of deze activiteit aan de CreateInstanceHelper in de basisklasse te delegeren.

3. Als er een bestaand domein met hetzelfde ActivationContextis, kan de activator de methodeaanroep CreateInstance delegeren naar het ApplicationActivator doeldomein. Houd er rekening mee dat dit een aanroep tussen domeinen zou zijn naar een die ApplicationActivator zich in het doel AppDomainbevindt.