Assembly クラス

定義

名前空間:

System.Reflection

アセンブリ:

System.Runtime.dll

ソース:

Assembly.cs

共通言語ランタイム アプリケーションの再利用可能でバージョン管理可能で自己記述型の構成要素であるアセンブリを表します。

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable

public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

継承

Object

Assembly

派生

System.Reflection.Emit.AssemblyBuilder

実装

ICustomAttributeProvider ISerializable

例

次のコード例は、現在実行中のアセンブリを取得し、そのアセンブリに含まれる型のインスタンスを作成し、遅延バインディングを使用して型のメソッドのいずれかを呼び出す方法を示しています。 この目的のために、コード例では、SampleMethodという名前のメソッドを使用して、Exampleという名前のクラスを定義します。 クラスのコンストラクターは整数を受け取ります。これは、メソッドの戻り値を計算するために使用されます。

このコード例では、GetName メソッドを使用して、アセンブリの完全な名前を解析するために使用できる AssemblyName オブジェクトを取得する方法も示します。 この例では、アセンブリのバージョン番号、CodeBase プロパティ、および EntryPoint プロパティを表示します。

using namespace System;
using namespace System::Reflection;
using namespace System::Security::Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")];

public ref class Example
{
private: 
    int factor;

public:
    Example(int f)
    {
        factor = f;
    }

    int SampleMethod(int x) 
    { 
        Console::WriteLine("\nExample->SampleMethod({0}) executes.", x);
        return x * factor;
    }
};

void main()
{
    Assembly^ assem = Example::typeid->Assembly;

    Console::WriteLine("Assembly Full Name:");
    Console::WriteLine(assem->FullName);

    // The AssemblyName type can be used to parse the full name.
    AssemblyName^ assemName = assem->GetName();
    Console::WriteLine("\nName: {0}", assemName->Name);
    Console::WriteLine("Version: {0}.{1}", 
        assemName->Version->Major, assemName->Version->Minor);

    Console::WriteLine("\nAssembly CodeBase:");
    Console::WriteLine(assem->CodeBase);

    // Create an object from the assembly, passing in the correct number and
    // type of arguments for the constructor.
    Object^ o = assem->CreateInstance("Example", false, 
        BindingFlags::ExactBinding, 
        nullptr, gcnew array<Object^> { 2 }, nullptr, nullptr);

    // Make a late-bound call to an instance method of the object.    
    MethodInfo^ m = assem->GetType("Example")->GetMethod("SampleMethod");
    Object^ ret = m->Invoke(o, gcnew array<Object^> { 42 });
    Console::WriteLine("SampleMethod returned {0}.", ret);

    Console::WriteLine("\nAssembly entry point:");
    Console::WriteLine(assem->EntryPoint);
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cpp/source.exe

Example->SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
UInt32 _mainCRTStartup()
 */

using System;
using System.Reflection;
using System.Security.Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")]

public class Example
{
    private int factor;
    public Example(int f)
    {
        factor = f;
    }

    public int SampleMethod(int x)
    {
        Console.WriteLine("\nExample.SampleMethod({0}) executes.", x);
        return x * factor;
    }

    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;

        Console.WriteLine("Assembly Full Name:");
        Console.WriteLine(assem.FullName);

        // The AssemblyName type can be used to parse the full name.
        AssemblyName assemName = assem.GetName();
        Console.WriteLine("\nName: {0}", assemName.Name);
        Console.WriteLine("Version: {0}.{1}",
            assemName.Version.Major, assemName.Version.Minor);

        Console.WriteLine("\nAssembly CodeBase:");
        Console.WriteLine(assem.CodeBase);

        // Create an object from the assembly, passing in the correct number
        // and type of arguments for the constructor.
        Object o = assem.CreateInstance("Example", false,
            BindingFlags.ExactBinding,
            null, new Object[] { 2 }, null, null);

        // Make a late-bound call to an instance method of the object.
        MethodInfo m = assem.GetType("Example").GetMethod("SampleMethod");
        Object ret = m.Invoke(o, new Object[] { 42 });
        Console.WriteLine("SampleMethod returned {0}.", ret);

        Console.WriteLine("\nAssembly entry point:");
        Console.WriteLine(assem.EntryPoint);
    }
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cs/source.exe

Example.SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
Void Main()
 */

Imports System.Reflection
Imports System.Security.Permissions

<assembly: AssemblyVersionAttribute("1.0.2000.0")>

Public Class Example
    Private factor As Integer
    
    Public Sub New(ByVal f As Integer) 
        factor = f
    End Sub 
    
    Public Function SampleMethod(ByVal x As Integer) As Integer 
        Console.WriteLine(vbCrLf & "Example.SampleMethod({0}) executes.", x)
        Return x * factor
    End Function 
    
    Public Shared Sub Main() 
        Dim assem As Assembly = GetType(Example).Assembly
        
        Console.WriteLine("Assembly Full Name:")
        Console.WriteLine(assem.FullName)
        
        ' The AssemblyName type can be used to parse the full name.
        Dim assemName As AssemblyName = assem.GetName()
        Console.WriteLine(vbLf + "Name: {0}", assemName.Name)
        Console.WriteLine("Version: {0}.{1}", assemName.Version.Major, _
            assemName.Version.Minor)
        
        Console.WriteLine(vbLf + "Assembly CodeBase:")
        Console.WriteLine(assem.CodeBase)
        
        ' Create an object from the assembly, passing in the correct number
        ' and type of arguments for the constructor.
        Dim o As Object = assem.CreateInstance("Example", False, _
            BindingFlags.ExactBinding, Nothing, _
            New Object() { 2 }, Nothing, Nothing)
        
        ' Make a late-bound call to an instance method of the object.    
        Dim m As MethodInfo = assem.GetType("Example").GetMethod("SampleMethod")
        Dim ret As Object = m.Invoke(o, New Object() { 42 })
        Console.WriteLine("SampleMethod returned {0}.", ret)
        
        Console.WriteLine(vbCrLf & "Assembly entry point:")
        Console.WriteLine(assem.EntryPoint)
    
    End Sub 
End Class 

' This code example produces output similar to the following:
'
'Assembly Full Name:
'source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null
'
'Name: source
'Version: 1.0
'
'Assembly CodeBase:
'file:///C:/sdtree/AssemblyClass/vb/source.exe
'
'Example.SampleMethod(42) executes.
'SampleMethod returned 84.
'
'Assembly entry point:
'Void Main()
'

注釈

アセンブリの読み込み、アセンブリのメタデータと構成要素の探索、アセンブリに含まれる型の検出、およびそれらの型のインスタンスの作成には、Assembly クラスを使用します。

アプリケーション ドメインに現在読み込まれているアセンブリ (単純なプロジェクトの既定のアプリケーション ドメインなど) を表す Assembly オブジェクトの配列を取得するには、AppDomain.GetAssemblies メソッドを使用します。

アセンブリを動的に読み込むには、Assembly クラスに次の静的メソッド (Visual Basic のShared メソッド) が用意されています。 アセンブリは、読み込み操作が行われるアプリケーション ドメインに読み込まれます。

• アセンブリを読み込むには、Load メソッドを使用することをお勧めします。このメソッドは、表示名で読み込まれるアセンブリを識別します (例: "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")。 アセンブリの検索は、「ランタイムがアセンブリを検索する方法」で説明されている規則に従います。

• ReflectionOnlyLoad メソッドと ReflectionOnlyLoadFrom メソッドを使用すると、リフレクション用にアセンブリを読み込むことができますが、実行には読み込めません。 たとえば、64 ビット プラットフォームを対象とするアセンブリは、32 ビット プラットフォームで実行されているコードによって調べることができます。

• LoadFile メソッドと LoadFrom メソッドは、アセンブリをパスで識別する必要があるまれなシナリオで提供されます。

現在実行中のアセンブリの Assembly オブジェクトを取得するには、GetExecutingAssembly メソッドを使用します。

Assembly クラスの多くのメンバーは、アセンブリに関する情報を提供します。 例えば：

• GetName メソッドは、アセンブリの表示名の部分へのアクセスを提供する AssemblyName オブジェクトを返します。

• GetCustomAttributes メソッドは、アセンブリに適用される属性を一覧表示します。

• GetFiles メソッドは、アセンブリ マニフェスト内のファイルへのアクセスを提供します。

• GetManifestResourceNames メソッドは、アセンブリ マニフェスト内のリソースの名前を提供します。

GetTypes メソッドは、アセンブリ内のすべての型を一覧表示します。 GetExportedTypes メソッドは、アセンブリの外部の呼び出し元に表示される型を一覧表示します。 GetType メソッドを使用して、アセンブリ内の特定の型を検索できます。 CreateInstance メソッドを使用して、アセンブリ内の型のインスタンスを検索および作成できます。

アセンブリの詳細については、「アプリケーション ドメイン」 トピックの「アプリケーション ドメインとアセンブリ」セクションを参照してください。

コンストラクター

Assembly()

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

プロパティ

CodeBase	古い. たとえば、AssemblyName オブジェクト内で、最初に指定したアセンブリの場所を取得します。
CustomAttributes	このアセンブリのカスタム属性を含むコレクションを取得します。
DefinedTypes	このアセンブリで定義されている型のコレクションを取得します。
EntryPoint	このアセンブリのエントリ ポイントを取得します。
EscapedCodeBase	古い. コードベースを表すエスケープ文字を含む URI を取得します。
ExportedTypes	アセンブリの外部に表示される、このアセンブリで定義されているパブリック型のコレクションを取得します。
FullName	アセンブリの表示名を取得します。
GlobalAssemblyCache	古い. アセンブリがグローバル アセンブリ キャッシュから読み込まれたかどうかを示す値を取得します (.NET Framework のみ)。
HostContext	アセンブリが読み込まれたホスト コンテキストを取得します。
ImageRuntimeVersion	マニフェストを含むファイルに保存されている共通言語ランタイム (CLR) のバージョンを表す文字列を取得します。
IsCollectible	このアセンブリが収集可能な AssemblyLoadContextに保持されているかどうかを示す値を取得します。
IsDynamic	リフレクション出力を使用して、現在のアセンブリが現在のプロセスで動的に生成されたかどうかを示す値を取得します。
IsFullyTrusted	現在のアセンブリが完全信頼で読み込まれるかどうかを示す値を取得します。
Location	マニフェストを含む読み込まれたファイルの完全なパスまたは UNC の場所を取得します。
ManifestModule	現在のアセンブリのマニフェストを含むモジュールを取得します。
Modules	このアセンブリ内のモジュールを含むコレクションを取得します。
ReflectionOnly	このアセンブリがリフレクションのみのコンテキストに読み込まれたかどうかを示す Boolean 値を取得します。
SecurityRuleSet	共通言語ランタイム (CLR) がこのアセンブリに適用するセキュリティ規則のセットを示す値を取得します。

メソッド

CreateInstance(String)	このアセンブリから指定した型を検索し、大文字と小文字を区別する検索を使用して、システム アクティベーターを使用してインスタンスを作成します。
CreateInstance(String, Boolean)	このアセンブリから指定した型を検索し、システム アクティベーターを使用してインスタンスを作成し、オプションで大文字と小文字を区別する検索を行います。
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	このアセンブリから指定した型を検索し、システム アクティベーターを使用してインスタンスを作成します。省略可能な大文字と小文字を区別する検索と、指定したカルチャ、引数、およびバインド属性とアクティブ化属性を持ちます。
CreateQualifiedName(String, String)	アセンブリの表示名で修飾された型の名前を作成します。
Equals(Object)	このアセンブリと指定したオブジェクトが等しいかどうかを判断します。
GetAssembly(Type)	指定した型が定義されている現在読み込まれているアセンブリを取得します。
GetCallingAssembly()	現在実行中のメソッドを呼び出したメソッドの Assembly を返します。
GetCustomAttributes(Boolean)	このアセンブリのすべてのカスタム属性を取得します。
GetCustomAttributes(Type, Boolean)	型で指定された、このアセンブリのカスタム属性を取得します。
GetCustomAttributesData()	現在の Assemblyに適用されている属性に関する情報 CustomAttributeData 返します。
GetEntryAssembly()	実行中のアプリケーションのエントリ アセンブリを取得します。
GetExecutingAssembly()	現在実行中のコードを含むアセンブリを取得します。
GetExportedTypes()	アセンブリの外部に表示される、このアセンブリで定義されているパブリック型を取得します。
GetFile(String)	このアセンブリのマニフェストのファイル テーブル内の指定したファイルの FileStream を取得します。
GetFiles()	アセンブリ マニフェストのファイル テーブル内のファイルを取得します。
GetFiles(Boolean)	リソース モジュールを含めるかどうかを指定して、アセンブリ マニフェストのファイル テーブル内のファイルを取得します。
GetForwardedTypes()	共通言語ランタイム アプリケーションの再利用可能でバージョン管理可能で自己記述型の構成要素であるアセンブリを表します。
GetHashCode()	このインスタンスのハッシュ コードを返します。
GetLoadedModules()	このアセンブリの一部である、読み込まれたすべてのモジュールを取得します。
GetLoadedModules(Boolean)	リソース モジュールを含めるかどうかを指定して、このアセンブリの一部である読み込まれたすべてのモジュールを取得します。
GetManifestResourceInfo(String)	指定されたリソースの永続化方法に関する情報を返します。
GetManifestResourceNames()	このアセンブリ内のすべてのリソースの名前を返します。
GetManifestResourceStream(String)	指定したマニフェスト リソースをこのアセンブリから読み込みます。
GetManifestResourceStream(Type, String)	このアセンブリから、指定した型の名前空間によってスコープ指定されたマニフェスト リソースを読み込みます。
GetModule(String)	このアセンブリ内の指定されたモジュールを取得します。
GetModules()	このアセンブリの一部であるすべてのモジュールを取得します。
GetModules(Boolean)	リソース モジュールを含めるかどうかを指定して、このアセンブリの一部であるすべてのモジュールを取得します。
GetName()	このアセンブリの AssemblyName を取得します。
GetName(Boolean)	このアセンブリの AssemblyName を取得し、copiedNameで指定されたコードベースを設定します。
GetObjectData(SerializationInfo, StreamingContext)	古い. このアセンブリを再作成するために必要なすべてのデータを含むシリアル化情報を取得します。
GetReferencedAssemblies()	このアセンブリによって参照されるすべてのアセンブリの AssemblyName オブジェクトを取得します。
GetSatelliteAssembly(CultureInfo)	指定したカルチャのサテライト アセンブリを取得します。
GetSatelliteAssembly(CultureInfo, Version)	指定したカルチャのサテライト アセンブリの指定したバージョンを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetType(String)	アセンブリ インスタンス内の指定した名前を持つ Type オブジェクトを取得します。
GetType(String, Boolean)	アセンブリ インスタンス内の指定した名前を持つ Type オブジェクトを取得し、必要に応じて、型が見つからない場合は例外をスローします。
GetType(String, Boolean, Boolean)	アセンブリ インスタンス内の指定した名前を持つ Type オブジェクトを取得します。大文字と小文字を区別せず、型が見つからない場合は例外をスローするオプションを指定します。
GetTypes()	このアセンブリで定義されているすべての型を取得します。
IsDefined(Type, Boolean)	指定した属性がアセンブリに適用されているかどうかを示します。
Load(AssemblyName)	AssemblyNameを指定してアセンブリを読み込みます。
Load(Byte[])	出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージを使用してアセンブリを読み込みます。
Load(Byte[], Byte[])	出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージ (必要に応じてアセンブリのシンボルを含む) を使用してアセンブリを読み込みます。
Load(String)	指定した名前のアセンブリを読み込みます。
LoadFile(String)	指定したパスにアセンブリ ファイルの内容を読み込みます。
LoadFrom(String)	ファイル名またはパスを指定してアセンブリを読み込みます。
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	ファイル名またはパス、ハッシュ値、ハッシュ アルゴリズムを指定してアセンブリを読み込みます。
LoadModule(String, Byte[])	出力されたモジュールまたはリソース ファイルを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージを使用して、このアセンブリの内部でモジュールを読み込みます。
LoadModule(String, Byte[], Byte[])	出力されたモジュールまたはリソース ファイルを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージを使用して、このアセンブリの内部でモジュールを読み込みます。 モジュールのシンボルを表す生バイトも読み込まれます。
LoadWithPartialName(String)	古い. 部分名を使用して、アプリケーション ディレクトリまたはグローバル アセンブリ キャッシュからアセンブリを読み込みます。
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ReflectionOnlyLoad(Byte[])	古い. 出力されたアセンブリを含む共通オブジェクト ファイル形式 (COFF) ベースのイメージからアセンブリを読み込みます。 アセンブリは、呼び出し元のアプリケーション ドメインのリフレクションのみのコンテキストに読み込まれます。
ReflectionOnlyLoad(String)	古い. 表示名を指定して、アセンブリをリフレクションのみのコンテキストに読み込みます。
ReflectionOnlyLoadFrom(String)	古い. パスを指定して、アセンブリをリフレクションのみのコンテキストに読み込みます。
ToString()	アセンブリの完全な名前 (表示名とも呼ばれます) を返します。
UnsafeLoadFrom(String)	一部のセキュリティ チェックをバイパスして、アセンブリを読み込みコンテキストに読み込みます。

演算子

Equality(Assembly, Assembly)	2 つの Assembly オブジェクトが等しいかどうかを示します。
Inequality(Assembly, Assembly)	2 つの Assembly オブジェクトが等しくないかどうかを示します。

イベント

ModuleResolve

共通言語ランタイム クラス ローダーが、通常の方法でアセンブリの内部モジュールへの参照を解決できない場合に発生します。

拡張メソッド

GetExportedTypes(Assembly)	共通言語ランタイム アプリケーションの再利用可能でバージョン管理可能で自己記述型の構成要素であるアセンブリを表します。
GetModules(Assembly)	共通言語ランタイム アプリケーションの再利用可能でバージョン管理可能で自己記述型の構成要素であるアセンブリを表します。
GetTypes(Assembly)	共通言語ランタイム アプリケーションの再利用可能でバージョン管理可能で自己記述型の構成要素であるアセンブリを表します。
GetCustomAttribute(Assembly, Type)	指定したアセンブリに適用される、指定した型のカスタム属性を取得します。
GetCustomAttribute<T>(Assembly)	指定したアセンブリに適用される、指定した型のカスタム属性を取得します。
GetCustomAttributes(Assembly)	指定したアセンブリに適用されるカスタム属性のコレクションを取得します。
GetCustomAttributes(Assembly, Type)	指定したアセンブリに適用される、指定した型のカスタム属性のコレクションを取得します。
GetCustomAttributes<T>(Assembly)	指定したアセンブリに適用される、指定した型のカスタム属性のコレクションを取得します。
IsDefined(Assembly, Type)	指定した型のカスタム属性が、指定したアセンブリに適用されるかどうかを示します。
TryGetRawMetadata(Assembly, Byte*, Int32)	MetadataReaderで使用するために、アセンブリのメタデータ セクションを取得します。

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください

• AppDomain
• AssemblyName
• アプリケーション ドメインの