ApplicationActivator クラス

リファレンス

定義

名前空間:: System.Runtime.Hosting

アセンブリ:: mscorlib.dll

重要

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

マニフェストに基づくアセンブリのアクティベーションの基本クラスを提供します。

public ref class ApplicationActivator

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

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

Public Class ApplicationActivator

継承: Object
ApplicationActivator

属性: ComVisibleAttribute

例

次のコード例は、マニフェストベースのアプリケーションの現在DomainManagerのからオブジェクトを取得ApplicationActivatorする方法を示しています。

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

注釈

各 AppDomain クラスには、すべてのアクティブ化呼び出しがApplicationActivatorルーティングされる、指定されたインスタンスが 1 つあります。現在AppDomainののはAppDomainManager、この目的のために独自のカスタムApplicationActivatorを提供できます。カスタム ApplicationActivator が指定されていない場合は、既定値 ApplicationActivator のインスタンスが作成されます。

次の手順では、既定 CreateInstance のメソッド実装の動作について説明します。

アクティブ化するアドインのが ActivationContext 現在のドメインのと ActivationContext 一致するかどうかを確認します。一致しない場合は、手順 2 に進みます。それ以外の場合は、アセンブリを実行し、オブジェクトハンドルにラップされた結果を返します。
新しい AppDomainでアドインをアクティブにします。アドインのを使用してActivationArguments新しい AppDomain を初期化するには、次の手順を実行します。
1. アドインのアクティブ化コンテキストをActivationArguments含むオブジェクトを使用して、新しい AppDomainSetup オブジェクトを作成します。
2. メソッドを CreateInstanceHelper 呼び出して、オブジェクトを使用して新しいドメインを AppDomainSetup 作成します。
3. メソッドは CreateInstanceHelper 、メソッドを HostSecurityManager.DetermineApplicationTrust 呼び出してアドインの ApplicationTrust オブジェクトを取得します。プロパティがを IsApplicationTrustedToRun 返す true場合は、アドインが実行されます。そうでない場合は、 CreateInstanceHelper 実行アクセス許可を取得できなかったことを示すをスロー PolicyException します。
4. アドインの実行が信頼されている場合は、アドインのに対ActivationContextして新しい AppDomain が作成および構成され、アドインが読み込まれて実行されます。
5. アドインのアクティブ化の結果が返され、オブジェクトハンドルにラップされます。

カスタムアクティベーターは、特定の状況に合わせてアドインのアクティブ化を調整できます。たとえば、カスタムアクティベーターは、毎回新しいドメインを作成する代わりに、このアドインをアクティブにする既存 AppDomain のものを見つけることができます。

次の手順では、既存AppDomainのでアドインをアクティブにするカスタムApplicationActivatorの動作について説明します。

カスタムアクティベーターは、アクティブ化されているアドインと同じ ActivationContext ドメインを検索します。
ActivationContextプロセスでがこれまでに見たことがない場合、カスタムアクティベーターは、メソッドを直接呼び出CreateDomainすか、基底クラスのにこのアクティビティをCreateInstanceHelper委任することで、このの新しい AppDomain ActivationContext を作成します。
同じ ActivationContextを持つ既存のドメインがある場合、アクティベーターは、ターゲットドメイン内の CreateInstance に ApplicationActivator メソッド呼び出しを委任できます。これは、ターゲットに存在するへの ApplicationActivator クロスドメイン呼び出しであることに注意してください AppDomain。

コンストラクター

ApplicationActivator()

ApplicationActivator クラスの新しいインスタンスを初期化します。

メソッド

CreateInstance(ActivationContext)	指定されたアクティベーションコンテキストを使用して、アクティブ化するアプリケーションのインスタンスを作成します。
CreateInstance(ActivationContext, String[])	指定したアクティブ化コンテキストとカスタムアクティブ化データを使用して、アクティブ化するアプリケーションのインスタンスを作成します。
CreateInstanceHelper(AppDomainSetup)	指定した AppDomainSetup オブジェクトを使用してアプリケーションのインスタンスを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

Share via

ApplicationActivator クラス

定義

例

注釈

コンストラクター

メソッド

適用対象

フィードバック

その他のリソース