Assembly 클래스

정의

네임스페이스:

System.Reflection

어셈블리:

System.Runtime.dll

Source:

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클래스를 정의합니다. 클래스의 생성자는 메서드의 반환 값을 계산하는 데 사용되는 정수(integer)를 허용합니다.

또한 코드 예제에서는 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	어셈블리 외부에 표시되는 이 어셈블리에 정의된 public 형식의 컬렉션을 가져옵니다.
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()	CustomAttributeData 개체로 표현된 현재 Assembly적용된 특성에 대한 정보를 반환합니다.
GetEntryAssembly()	실행 중인 애플리케이션에 대한 항목 어셈블리를 가져옵니다.
GetExecutingAssembly()	현재 실행 중인 코드가 포함된 어셈블리를 가져옵니다.
GetExportedTypes()	어셈블리 외부에 표시되는 이 어셈블리에 정의된 public 형식을 가져옵니다.
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)	copiedName지정된 대로 코드베이스를 설정하여 이 어셈블리에 대한 AssemblyName 가져옵니다.
GetObjectData(SerializationInfo, StreamingContext)	사용되지 않음. 이 어셈블리를 다시 검증하는 데 필요한 모든 데이터를 사용하여 serialization 정보를 가져옵니다.
GetReferencedAssemblies()	이 어셈블리에서 참조하는 모든 어셈블리의 AssemblyName 개체를 가져옵니다.
GetSatelliteAssembly(CultureInfo)	지정된 문화권의 위성 어셈블리를 가져옵니다.
GetSatelliteAssembly(CultureInfo, Version)	지정된 문화권에 대한 위성 어셈블리의 지정된 버전을 가져옵니다.
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
GetType(String)	어셈블리 인스턴스에서 지정된 이름을 가진 Type 개체를 가져옵니다.
GetType(String, Boolean)	어셈블리 인스턴스에서 지정된 이름을 가진 Type 개체를 가져오고 형식을 찾을 수 없는 경우 필요에 따라 예외를 throw합니다.
GetType(String, Boolean, Boolean)	대/소문자를 무시하고 형식을 찾을 수 없는 경우 예외를 throw하는 옵션을 사용하여 어셈블리 인스턴스에서 지정된 이름을 가진 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)	두 Assembly 개체가 같은지 여부를 나타냅니다.
Inequality(Assembly, Assembly)	두 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
• 애플리케이션 도메인