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

예제

다음 코드 예제에서는 현재 실행 중인 어셈블리를 가져오고, 해당 어셈블리에 포함된 형식의 instance 만들고, 지연 바인딩을 사용하여 형식의 메서드 중 하나를 호출하는 방법을 보여 줍니다. 이를 위해 코드 예제에서는 라는 메서드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 다음과 같은 정적 메서드(Shared Visual Basic의 메서드)를 제공합니다. 어셈블리 로드 작업이 발생 하는 애플리케이션 도메인에 로드 됩니다.

• 어셈블리를 로드하는 권장 방법은 표시 이름으로 로드할 어셈블리를 식별하는 메서드를 사용하는 Load 것입니다(예: "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). 어셈블리 검색은 런타임에서 어셈블리를 찾는 방법에 설명된 규칙을 따릅니다.

• ReflectionOnlyLoad 및 ReflectionOnlyLoadFrom 메서드를 사용하면 리플렉션을 위해 어셈블리를 로드할 수 있지만 실행할 수는 없습니다. 예를 들어 64비트 플랫폼을 대상으로 하는 어셈블리는 32비트 플랫폼에서 실행되는 코드로 검사할 수 있습니다.

• 및 LoadFrom 메서드는 LoadFile 경로로 어셈블리를 식별해야 하는 드문 시나리오에 대해 제공됩니다.

현재 실행 중인 어셈블리에 대한 개체를 얻으려면 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()	Assembly 개체로 표현되는, 현재 CustomAttributeData에 적용된 특성 관련 정보를 반환합니다.
GetEntryAssembly()	기본 애플리케이션 도메인에 있는 프로세스 실행 파일을 가져옵니다. 이 실행 파일은 다른 애플리케이션 도메인에서 ExecuteAssembly(String)에 의해 실행된 첫 번째 실행 파일입니다.
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)	이 어셈블리에 대한 AssemblyName을 가져오며 copiedName에 의해 지정된 대로 코드베이스를 설정합니다.
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(Common Object File Format) 기반 이미지를 사용하여 어셈블리를 로드합니다.
Load(Byte[], Byte[])	생성된 어셈블리가 들어 있고 경우에 따라 어셈블리에 대한 기호도 포함하는 COFF(공용 개체 파일 형식) 기반 이미지를 사용하여 어셈블리를 로드합니다.
Load(String)	지정된 이름으로 어셈블리를 로드합니다.
LoadFile(String)	지정된 경로에 있는 어셈블리 파일의 내용을 로드합니다.
LoadFrom(String)	해당 파일 이름이나 경로가 지정된 어셈블리를 로드합니다.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	해당 파일 이름이나 경로가 지정된 어셈블리, 해시 값 및 해시 알고리즘을 로드합니다.
LoadModule(String, Byte[])	내보낸 모듈인 리소스 파일이 포함된 COFF(Common Object File Format) 기반 이미지가 포함된 이 어셈블리의 내부 모듈을 로드합니다.
LoadModule(String, Byte[], Byte[])	내보낸 모듈인 리소스 파일이 포함된 COFF(Common Object File Format) 기반 이미지가 포함된 이 어셈블리의 내부 모듈을 로드합니다. 모듈의 기호를 나타내는 원시 바이트도 로드됩니다.
LoadWithPartialName(String)	사용되지 않음. 부분 이름을 사용하여 애플리케이션 디렉터리 또는 전역 어셈블리 캐시에서 어셈블리를 로드합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ReflectionOnlyLoad(Byte[])	사용되지 않음. 내보낸 어셈블리가 포함된 COFF(Common Object File Format) 기반 이미지에서 어셈블리를 로드합니다. 어셈블리는 호출자 애플리케이션 도메인의 리플렉션 전용 컨텍스트에 로드됩니다.
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
• 애플리케이션 도메인