ActivationArguments

.NET Framework クラス ライブラリ リファレンス

ActivationArguments クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションのマニフェストに基づくアクティベーション用のデータを提供します。このクラスは継承できません。

名前空間: System.Runtime.Hosting
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ActivationArguments

Visual Basic (使用法)

Dim instance As ActivationArguments

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class ActivationArguments

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class ActivationArguments sealed

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class ActivationArguments

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public final class ActivationArguments

解説

ActivationArguments クラスは、AppDomainSetup クラスによって使用されます。

マニフェストに基づくアクティベーション モデルでは、アクティベーション用のアセンブリではなく、アプリケーション マニフェストを使用します。マニフェストで、アプリケーション、アプリケーションの依存関係、セキュリティ要件などを完全に記述します。マニフェスト モデルには、特に Web アプリケーションの場合に、アセンブリに基づくアクティベーション モデルより優れたいくつかのメリットがあります。たとえば、マニフェストには、アプリケーションのセキュリティ要件が格納されますが、これにより、コードをダウンロードする前にアプリケーションを実行できるようにするかどうかをユーザーが決定できます。マニフェストには、アプリケーションの依存関係に関する情報も格納されます。

使用例

マニフェストに基づくアプリケーションの AppDomain の AppDomainSetup から、現在の ActivationArguments オブジェクトを取得する方法を次のコード例に示します。

Visual Basic

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)
        '<Snippet2
        ' 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

C#

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

namespace ActivationContextSample
{
    public class Program : MarshalByRefObject
    {
        [SecurityPermission(SecurityAction.LinkDemand, ControlDomainPolicy=true)]
        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();
        }
    [SecurityPermission(SecurityAction.LinkDemand, ControlDomainPolicy=true)]
        public void Run()
        {
            Main(new string[] { });
            Console.ReadLine();
        }
    }
}

継承階層

System.Object
  System.Runtime.Hosting.ActivationArguments

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments コンストラクタ (ActivationContext)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

アクティベーション コンテキストを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Hosting
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    activationData As ActivationContext _
)

Visual Basic (使用法)

Dim activationData As ActivationContext

Dim instance As New ActivationArguments(activationData)

C#

public ActivationArguments (
    ActivationContext activationData
)

C++

public:
ActivationArguments (
    ActivationContext^ activationData
)

J#

public ActivationArguments (
    ActivationContext activationData
)

JScript

public function ActivationArguments (
    activationData : ActivationContext
)

パラメータ

activationData

マニフェストに基づくアクティベーション アプリケーションを識別する ActivationContext オブジェクト。

例外

例外の種類	条件
ArgumentNullException	activationData が null 参照 (Visual Basic では Nothing) です。

解説

activationData パラメータによって表される ActivationContext オブジェクトには、マニフェストに基づくアクティベーションの ApplicationIdentity とコンテキスト情報が格納されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActivationArguments クラス
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments コンストラクタ (ApplicationIdentity)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション ID を指定して、ActivationArguments クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Hosting
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    applicationIdentity As ApplicationIdentity _
)

Visual Basic (使用法)

Dim applicationIdentity As ApplicationIdentity

Dim instance As New ActivationArguments(applicationIdentity)

C#

public ActivationArguments (
    ApplicationIdentity applicationIdentity
)

C++

public:
ActivationArguments (
    ApplicationIdentity^ applicationIdentity
)

J#

public ActivationArguments (
    ApplicationIdentity applicationIdentity
)

JScript

public function ActivationArguments (
    applicationIdentity : ApplicationIdentity
)

パラメータ

applicationIdentity

マニフェストに基づくアクティベーション アプリケーションを識別する ApplicationIdentity オブジェクト。

例外

例外の種類	条件
ArgumentNullException	applicationIdentity が null 参照 (Visual Basic では Nothing) です。

解説

アプリケーション ID は、新しいドメインでアクティブにする、マニフェストに基づくアプリケーションを一意に識別します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActivationArguments クラス
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments コンストラクタ (ActivationContext, String[])

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

アクティベーション コンテキストとアクティベーション データを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Hosting
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    activationContext As ActivationContext, _
    activationData As String() _
)

Visual Basic (使用法)

Dim activationContext As ActivationContext
Dim activationData As String()

Dim instance As New ActivationArguments(activationContext,
 activationData)

C#

public ActivationArguments (
    ActivationContext activationContext,
    string[] activationData
)

C++

public:
ActivationArguments (
    ActivationContext^ activationContext, 
    array<String^>^ activationData
)

J#

public ActivationArguments (
    ActivationContext activationContext, 
    String[] activationData
)

JScript

public function ActivationArguments (
    activationContext : ActivationContext, 
    activationData : String[]
)

パラメータ

activationContext

マニフェストに基づくアクティベーション アプリケーションを識別する ActivationContext オブジェクト。

activationData

ホストから提供されたアクティベーション データを格納する文字列の配列。

例外

例外の種類	条件
ArgumentNullException	activationContext が null 参照 (Visual Basic では Nothing) です。

解説

activationContext パラメータによって表される ActivationContext オブジェクトには、マニフェストに基づくアクティベーションの ApplicationIdentity とコンテキスト情報が格納されます。アクティベーション データは、URL 内のクエリ文字列部分などの情報から構成されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActivationArguments クラス
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments コンストラクタ (ApplicationIdentity, String[])

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション ID とアクティベーション データを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Hosting
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    applicationIdentity As ApplicationIdentity, _
    activationData As String() _
)

Visual Basic (使用法)

Dim applicationIdentity As ApplicationIdentity
Dim activationData As String()

Dim instance As New ActivationArguments(applicationIdentity,
 activationData)

C#

public ActivationArguments (
    ApplicationIdentity applicationIdentity,
    string[] activationData
)

C++

public:
ActivationArguments (
    ApplicationIdentity^ applicationIdentity, 
    array<String^>^ activationData
)

J#

public ActivationArguments (
    ApplicationIdentity applicationIdentity, 
    String[] activationData
)

JScript

public function ActivationArguments (
    applicationIdentity : ApplicationIdentity, 
    activationData : String[]
)

パラメータ

applicationIdentity

マニフェストに基づくアクティベーション アプリケーションを識別する ApplicationIdentity オブジェクト。

activationData

ホストから提供されたアクティベーション データを格納する文字列の配列。

例外

例外の種類	条件
ArgumentNullException	applicationIdentity が null 参照 (Visual Basic では Nothing) です。

解説

アプリケーション ID は、新しいドメインでアクティブにする、マニフェストに基づくアプリケーションを一意に識別します。アクティベーション データは、URL 内のクエリ文字列部分などの情報から構成されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActivationArguments クラス
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments コンストラクタ

ActivationArguments クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ActivationArguments (ActivationContext)	アクティベーション コンテキストを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。
ActivationArguments (ApplicationIdentity)	アプリケーション ID を指定して、ActivationArguments クラスの新しいインスタンスを初期化します。
ActivationArguments (ActivationContext, String[])	アクティベーション コンテキストとアクティベーション データを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。
ActivationArguments (ApplicationIdentity, String[])	アプリケーション ID とアクティベーション データを指定して、ActivationArguments クラスの新しいインスタンスを初期化します。

参照

関連項目

ActivationArguments クラス
ActivationArguments メンバ
System.Runtime.Hosting 名前空間

ActivationArguments プロパティ

パブリック プロパティ

	名前	説明
	ActivationContext	アプリケーションのマニフェストに基づくアクティベーション用のアクティベーション コンテキストを取得します。
	ActivationData	ホストからアクティベーション データを取得します。
	ApplicationIdentity	マニフェストに基づいてアクティベートされるアプリケーションのアプリケーション ID を取得します。

参照

関連項目

ActivationArguments クラス
System.Runtime.Hosting 名前空間

ActivationArguments メソッド

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

参照

関連項目

ActivationArguments クラス
System.Runtime.Hosting 名前空間

ActivationArguments メンバ

アプリケーションのマニフェストに基づくアクティベーション用のデータを提供します。このクラスは継承できません。

ActivationArguments データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	ActivationArguments	オーバーロードされます。 ActivationArguments クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ActivationContext	アプリケーションのマニフェストに基づくアクティベーション用のアクティベーション コンテキストを取得します。
	ActivationData	ホストからアクティベーション データを取得します。
	ApplicationIdentity	マニフェストに基づいてアクティベートされるアプリケーションのアプリケーション ID を取得します。

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

参照

関連項目

ActivationArguments クラス
System.Runtime.Hosting 名前空間