AssemblyName 클래스

정의

네임스페이스:

System.Reflection

어셈블리:

netstandard.dll, System.Runtime.dll

Source:

AssemblyName.cs

어셈블리의 고유 ID를 전체적으로 설명합니다.

public ref class AssemblyName sealed : ICloneable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class AssemblyName : ICloneable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type AssemblyName = class
    interface ICloneable
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class AssemblyName
Implements ICloneable, IDeserializationCallback, ISerializable

상속

Object

AssemblyName

구현

ICloneable IDeserializationCallback ISerializable

예제

이 예제에서는 다양한 리플렉션 클래스를 사용하여 어셈블리에 포함된 메타데이터를 분석하는 방법을 보여 줍니다.

using System;
using System.Reflection;

class Module1
{
    public static void Main()
    {
        // This variable holds the amount of indenting that
        // should be used when displaying each line of information.
        Int32 indent = 0;
        // Display information about the EXE assembly.
        Assembly a = typeof(Module1).Assembly;
        Display(indent, "Assembly identity={0}", a.FullName);
        Display(indent+1, "Codebase={0}", a.CodeBase);

        // Display the set of assemblies our assemblies reference.

        Display(indent, "Referenced assemblies:");
        foreach (AssemblyName an in a.GetReferencedAssemblies() )
        {
             Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", an.Name, an.Version, an.CultureInfo.Name, (BitConverter.ToString (an.GetPublicKeyToken())));
        }
        Display(indent, "");

        // Display information about each assembly loading into this AppDomain.
        foreach (Assembly b in AppDomain.CurrentDomain.GetAssemblies())
        {
            Display(indent, "Assembly: {0}", b);

            // Display information about each module of this assembly.
            foreach ( Module m in b.GetModules(true) )
            {
                Display(indent+1, "Module: {0}", m.Name);
            }

            // Display information about each type exported from this assembly.

            indent += 1;
            foreach ( Type t in b.GetExportedTypes() )
            {
                Display(0, "");
                Display(indent, "Type: {0}", t);

                // For each type, show its members & their custom attributes.

                indent += 1;
                foreach (MemberInfo mi in t.GetMembers() )
                {
                    Display(indent, "Member: {0}", mi.Name);
                    DisplayAttributes(indent, mi);

                    // If the member is a method, display information about its parameters.

                    if (mi.MemberType==MemberTypes.Method)
                    {
                        foreach ( ParameterInfo pi in ((MethodInfo) mi).GetParameters() )
                        {
                            Display(indent+1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name);
                        }
                    }

                    // If the member is a property, display information about the property's accessor methods.
                    if (mi.MemberType==MemberTypes.Property)
                    {
                        foreach ( MethodInfo am in ((PropertyInfo) mi).GetAccessors() )
                        {
                            Display(indent+1, "Accessor method: {0}", am);
                        }
                    }
                }
                indent -= 1;
            }
            indent -= 1;
        }
    }

    // Displays the custom attributes applied to the specified member.
    public static void DisplayAttributes(Int32 indent, MemberInfo mi)
    {
        // Get the set of custom attributes; if none exist, just return.
        object[] attrs = mi.GetCustomAttributes(false);
        if (attrs.Length==0) {return;}

        // Display the custom attributes applied to this member.
        Display(indent+1, "Attributes:");
        foreach ( object o in attrs )
        {
            Display(indent+2, "{0}", o.ToString());
        }
    }

    // Display a formatted string indented by the specified amount.
    public static void Display(Int32 indent, string format, params object[] param)

    {
        Console.Write(new string(' ', indent*2));
        Console.WriteLine(format, param);
    }
}

//The output shown below is abbreviated.
//
//Assembly identity=ReflectionCS, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
//  Codebase=file:///C:/Documents and Settings/test/My Documents/Visual Studio 2005/Projects/Reflection/Reflection/obj/Debug/Reflection.exe
//Referenced assemblies:
//  Name=mscorlib, Version=2.0.0.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
//
//Assembly: mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//
//  Type: System.Object
//    Member: GetType
//    Member: ToString
//    Member: Equals
//      Parameter: Type=System.Object, Name=obj
//    Member: Equals
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: ReferenceEquals
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: GetHashCode
//    Member: .ctor
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//
//  Type: System.ICloneable
//    Member: Clone
//
//  Type: System.Collections.IEnumerable
//    Member: GetEnumerator
//      Attributes:
//        System.Runtime.InteropServices.DispIdAttribute
//
//  Type: System.Collections.ICollection
//    Member: CopyTo
//      Parameter: Type=System.Array, Name=array
//      Parameter: Type=System.Int32, Name=index
//    Member: get_Count
//    Member: get_SyncRoot
//    Member: get_IsSynchronized
//    Member: Count
//      Accessor method: Int32 get_Count()
//    Member: SyncRoot
//      Accessor method: System.Object get_SyncRoot()
//    Member: IsSynchronized
//      Accessor method: Boolean get_IsSynchronized()
//
//  Type: System.Collections.IList
//    Member: get_Item
//      Parameter: Type=System.Int32, Name=index
//    Member: set_Item
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Add
//      Parameter: Type=System.Object, Name=value
//    Member: Contains
//      Parameter: Type=System.Object, Name=value
//    Member: Clear
//    Member: get_IsReadOnly
//    Member: get_IsFixedSize
//    Member: IndexOf
//      Parameter: Type=System.Object, Name=value
//    Member: Insert
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Remove
//      Parameter: Type=System.Object, Name=value
//    Member: RemoveAt
//      Parameter: Type=System.Int32, Name=index
//    Member: Item
//      Accessor method: System.Object get_Item(Int32)
//      Accessor method: Void set_Item(Int32, System.Object)
//    Member: IsReadOnly
//      Accessor method: Boolean get_IsReadOnly()
//    Member: IsFixedSize
//      Accessor method: Boolean get_IsFixedSize()
//
//  Type: System.Array
//    Member: IndexOf
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: AsReadOnly
//      Parameter: Type=T[], Name=array
//    Member: Resize
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[]&, Name=array
//      Parameter: Type=System.Int32, Name=newSize
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//      Parameter: Type=System.Collections.Generic.IComparer`1[T], Name=comparer

Imports System.Reflection

Module Module1
    Sub Main()
        ' This variable holds the amount of indenting that 
        ' should be used when displaying each line of information.
        Dim indent As Int32 = 0
        ' Display information about the EXE assembly.
        Dim a As Assembly = GetType(Module1).Assembly
        Display(indent, "Assembly identity={0}", a.FullName)
        Display(indent + 1, "Codebase={0}", a.CodeBase)

        ' Display the set of assemblies our assemblies reference.
        Dim an As AssemblyName
        Display(indent, "Referenced assemblies:")
        For Each an In a.GetReferencedAssemblies()
            Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", _
                an.Name, an.Version, an.CultureInfo.Name, BitConverter.ToString(an.GetPublicKeyToken))
        Next
        Display(indent, "")

        ' Display information about each assembly loading into this AppDomain.
        For Each a In AppDomain.CurrentDomain.GetAssemblies()
            Display(indent, "Assembly: {0}", a)

            ' Display information about each module of this assembly.
            Dim m As [Module]
            For Each m In a.GetModules(True)
                Display(indent + 1, "Module: {0}", m.Name)
            Next

            ' Display information about each type exported from this assembly.
            Dim t As Type
            indent += 1
            For Each t In a.GetExportedTypes()
                Display(0, "")
                Display(indent, "Type: {0}", t)

                ' For each type, show its members & their custom attributes.
                Dim mi As MemberInfo
                indent += 1
                For Each mi In t.GetMembers()
                    Display(indent, "Member: {0}", mi.Name)
                    DisplayAttributes(indent, mi)

                    ' If the member is a method, display information about its parameters.
                    Dim pi As ParameterInfo
                    If mi.MemberType = MemberTypes.Method Then
                        For Each pi In CType(mi, MethodInfo).GetParameters()
                            Display(indent + 1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name)
                        Next
                    End If

                    ' If the member is a property, display information about the property's accessor methods.
                    If mi.MemberType = MemberTypes.Property Then
                        Dim am As MethodInfo
                        For Each am In CType(mi, PropertyInfo).GetAccessors()
                            Display(indent + 1, "Accessor method: {0}", am)
                        Next
                    End If
                Next
                indent -= 1
            Next
            indent -= 1
        Next
    End Sub

    ' Displays the custom attributes applied to the specified member.
    Sub DisplayAttributes(ByVal indent As Int32, ByVal mi As MemberInfo)
        ' Get the set of custom attributes; if none exist, just return.
        Dim attrs() As Object = mi.GetCustomAttributes(False)
        If attrs.Length = 0 Then Return

        ' Display the custom attributes applied to this member.
        Display(indent + 1, "Attributes:")
        Dim o As Object
        For Each o In attrs
            Display(indent + 2, "{0}", o.ToString())
        Next
    End Sub

    ' Display a formatted string indented by the specified amount.
    Sub Display(ByVal indent As Int32, ByVal format As String, ByVal ParamArray params() As Object)
        Console.Write(New String(" "c, indent * 2))
        Console.WriteLine(format, params)
    End Sub
End Module

'The output shown below is abbreviated.
'
'Assembly identity=Reflection, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
'  Codebase=file:///C:/Reflection.exe
'Referenced assemblies:
'  Name=mscorlib, Version=1.0.5000.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
'  Name=Microsoft.VisualBasic, Version=7.0.5000.0, Culture=, PublicKey token=B0-3F-5F-7F-11-D5-0A-3A
'
'Assembly: mscorlib, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
'  Module: mscorlib.dll
'  Module: prc.nlp
'  Module: prcp.nlp
'  Module: ksc.nlp
'  Module: ctype.nlp
'  Module: xjis.nlp
'  Module: bopomofo.nlp
'  Module: culture.nlp
'  Module: region.nlp
'  Module: sortkey.nlp
'  Module: charinfo.nlp
'  Module: big5.nlp
'  Module: sorttbls.nlp
'  Module: l_intl.nlp
'  Module: l_except.nlp
'
'  Type: System.Object
'    Member: GetHashCode
'    Member: Equals
'      Parameter: Type=System.Object, Name=obj
'    Member: ToString
'    Member: Equals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: ReferenceEquals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: GetType
'    Member: .ctor
'
'  Type: System.ICloneable
'    Member: Clone
'
'  Type: System.Collections.IEnumerable
'    Member: GetEnumerator
'      Attributes:
'        System.Runtime.InteropServices.DispIdAttribute
'
'  Type: System.Collections.ICollection
'    Member: get_IsSynchronized
'    Member: get_SyncRoot
'    Member: get_Count
'    Member: CopyTo
'      Parameter: Type=System.Array, Name=array
'      Parameter: Type=System.Int32, Name=index
'    Member: Count
'      Accessor method: Int32 get_Count()
'    Member: SyncRoot
'      Accessor method: System.Object get_SyncRoot()
'    Member: IsSynchronized
'      Accessor method: Boolean get_IsSynchronized()
'

설명

개체에는 AssemblyName 어셈블리에 바인딩하는 데 사용할 수 있는 어셈블리에 대한 정보가 포함되어 있습니다. 어셈블리의 ID는 다음으로 구성됩니다.

• 단순 이름입니다.
• 버전 번호.
• 암호화 키 쌍입니다.
• 지원되는 문화권입니다.

단순 이름은 일반적으로 확장명을 사용하지 않는 매니페스트 파일의 파일 이름입니다. 키 쌍에는 어셈블리에 대한 강력한 이름 서명을 만드는 데 사용되는 퍼블릭 및 프라이빗 키가 포함됩니다.

공용 언어 런타임을 지원하는 모든 컴파일러는 중첩 클래스의 단순 이름을 내보내고, 리플렉션은 다음 규칙에 따라 쿼리할 때 잘못된 이름을 생성합니다.

구분 기호	Meaning
백슬래시(\)	이스케이프 문자입니다.
쉼표(,)	어셈블리 이름 앞에 섰습니다.
더하기 기호(+)	중첩 클래스 앞에 섰습니다.

예를 들어 클래스의 정규화된 이름은 다음과 같을 수 있습니다.

ContainingClass+NestedClass,MyAssembly

"++"는 "\+\+"가 되고 "\"는 "\\"가 됩니다.

이 정규화된 이름은 저장할 수 있으며 나중에 Type를 로드하는 데 사용할 수 있습니다. 검색하고 로드 Type하려면 형식 이름만 사용하거나 어셈블리에 정규화된 형식 이름을 사용합니다 GetType . GetType 형식 이름이 있는 경우 호출자의 어셈블리와 시스템 어셈블리에서만 찾 Type 습니다. GetType 정규화된 어셈블리 형식 이름을 가진 어셈블리는 모든 어셈블리에서 찾 Type 습니다.

완전히 지정된 AssemblyName 이름, 문화권, 공개 키 또는 공개 키 토큰, 주 버전, 부 버전, 빌드 번호 및 수정 번호 매개 변수가 있어야 합니다. 마지막 4개는 형식으로 Version 패키지됩니다.

간단한 이름을 만들려면 매개 변수가 AssemblyName 없는 생성자를 사용하여 개체를 만들고 .Name 다른 속성은 선택 사항입니다.

전체 강력한 이름을 만들려면 매개 변수가 AssemblyName 없는 생성자를 사용하여 개체를 만들고 andKeyPair를 Name 설정합니다. 다른 속성은 선택 사항입니다. 공개 키와 SetPublicKeyToken 강력한 이름을 사용하고 SetPublicKey 설정합니다. 강력한 이름 서명은 항상 해시 알고리즘을 SHA1 사용합니다.

이름이 올바르게 생성되었는지 확인하려면 다음 속성을 사용합니다.

• Assembly.FullName
• AssemblyName.FullName
• Type.AssemblyQualifiedName

Gacutil.exe 옵션을 사용하여 /l 이름을 가져올 수도 있습니다 (전역 어셈블리 캐시 도구).

부분적으로 지정된 강력한 이름의 경우 매개 변수가 AssemblyName 없는 생성자를 사용하여 개체를 만들고 이름 및 공개 키를 설정합니다. 이러한 어셈블리를 사용하여 만든 어셈블리는 AssemblyName 나중에 어셈블리 링커(Al.exe)를 사용하여 서명할 수 있습니다.

공개 키와 KeyPair 일치하지 않는 값을 지정할 수 있습니다. 이는 개발자 시나리오에서 유용할 수 있습니다. 이 경우 검색된 공개 키는 GetPublicKey 올바른 공개 키를 지정하고 KeyPair 개발 중에 사용되는 퍼블릭 및 프라이빗 키를 지정합니다. 런타임이 공개 키와 공개 키 간의 불일치를 KeyPair 감지하면 레지스트리에서 공개 키와 일치하는 올바른 키를 조회합니다.

표시 이름의 AssemblyName 형식은 다음과 같이 이름으로 시작하는 쉼표로 구분된 유니코드 문자열입니다.

Name <,Culture = CultureInfo> <,Version = Major.Minor.Build.Revision> <, StrongName> <,PublicKeyToken> '\0'

Name 는 어셈블리의 텍스트 이름입니다. CultureInfo 는 RFC1766 형식 정의 문화권입니다. Major, Minor, Build및 Revision 주 버전, 부 버전, 빌드 번호 및 어셈블리의 수정 번호입니다. StrongName 는 SHA-1 해시 알고리즘 및 지정된 공개 키를 사용하여 생성된 공개 키의 해시 값의 16진수로 인코딩된 SetPublicKey하위 64비트입니다. PublicKeyToken 는 로 지정된 16진수로 인코딩된 SetPublicKey공개 키입니다.

16진수 인코딩은 이진 개체의 각 바이트를 두 개의 16진수 문자로 변환하여 최소 바이트에서 가장 중요한 바이트로 진행하는 것으로 정의됩니다. 필요에 따라 추가 표시 값이 추가됩니다.

전체 공개 키가 알려진 경우 PublicKey가 StrongName으로 대체될 수 있습니다.

또한 먼저 와야 하는 경우를 Name제외하고 매개 변수의 어휘 순서는 중요하지 않습니다. 그러나 특별히 설정되지 않은 매개 변수(StrongNameVersionCulture또는PublicKey)는 생략된 것으로 간주되며 AssemblyName 부분적인 것으로 간주됩니다. 부분 정보를 지정할 때는 위에서 설명한 순서대로 이름 매개 변수를 지정해야 합니다.

표시 이름을 제공할 때 규칙 StrongName =null 이나 PublicKey= null 단순히 명명된 어셈블리에 대한 바인딩 및 일치가 필요했음을 나타냅니다. 또한 규칙 Culture= "" (빈 문자열을 나타내는 큰따옴표)은 기본 문화권과 일치를 나타냅니다.

다음 예제에서는 기본 문화권 AssemblyName 이 있는 단순히 명명된 어셈블리에 대한 예제입니다.

ExampleAssembly, Culture=""

다음 예제에서는 문화권이 "en"인 강력한 이름의 어셈블리에 대해 완전히 지정된 참조를 보여줍니다.

ExampleAssembly, Version=1.0.0.0, Culture=en, PublicKeyToken=a5d015c7d5a0b012

생성자

Name	Description
AssemblyName()	AssemblyName 클래스의 새 인스턴스를 초기화합니다.
AssemblyName(String)	지정된 표시 이름을 사용하여 클래스의 AssemblyName 새 인스턴스를 초기화합니다.

속성

Name	Description
CodeBase	사용되지 않음. 어셈블리의 위치를 URL로 가져오거나 설정합니다.
ContentType	어셈블리에 포함된 콘텐츠 형식을 나타내는 값을 가져오거나 설정합니다.
CultureInfo	어셈블리에서 지원하는 문화권을 가져오거나 설정합니다.
CultureName	어셈블리와 연결된 문화권의 이름을 가져오거나 설정합니다.
EscapedCodeBase	사용되지 않음. 코드베이스를 나타내는 이스케이프 문자를 포함한 URI를 가져옵니다.
Flags	어셈블리의 특성을 가져오거나 설정합니다.
FullName	표시 이름이라고도 하는 어셈블리의 전체 이름을 가져옵니다.
HashAlgorithm	사용되지 않음. 어셈블리 매니페스트에서 사용하는 해시 알고리즘을 가져오거나 설정합니다.
KeyPair	사용되지 않음. 어셈블리에 대한 강력한 이름 서명을 만드는 데 사용되는 퍼블릭 및 프라이빗 암호화 키 쌍을 가져오거나 설정합니다.
Name	어셈블리의 단순 이름을 가져오거나 설정합니다. 일반적으로 어셈블리 매니페스트 파일의 파일 이름에서 확장명을 뺀 파일 이름일 필요는 없습니다.
ProcessorArchitecture	사용되지 않음. 실행 파일이 대상으로 하는 플랫폼의 프로세서 및 단어당 비트 수를 식별하는 값을 가져오거나 설정합니다.
Version	어셈블리의 주, 부, 빌드 및 수정 번호를 가져오거나 설정합니다.
VersionCompatibility	사용되지 않음. 어셈블리와 다른 어셈블리의 호환성과 관련된 정보를 가져오거나 설정합니다.

메서드

Name	Description
Clone()	이 AssemblyName 개체의 복사본을 만듭니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetAssemblyName(String)	AssemblyName 지정된 파일에 대한 값을 가져옵니다.
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetObjectData(SerializationInfo, StreamingContext)	사용되지 않음. 이 AssemblyName인스턴스를 다시 만드는 데 필요한 모든 데이터를 사용하여 serialization 정보를 가져옵니다.
GetPublicKey()	어셈블리의 공개 키를 가져옵니다.
GetPublicKeyToken()	애플리케이션 또는 어셈블리가 서명된 공개 키의 SHA-1 해시의 마지막 8바이트인 공개 키 토큰을 가져옵니다.
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnDeserialization(Object)	인터페이스를 ISerializable 구현하고 역직렬화가 완료되면 역직렬화 이벤트에 의해 다시 호출됩니다.
ReferenceMatchesDefinition(AssemblyName, AssemblyName)	두 어셈블리 이름이 같은지 여부를 나타내는 값을 반환합니다. 비교는 간단한 어셈블리 이름을 기반으로 합니다.
SetPublicKey(Byte[])	어셈블리를 식별하는 공개 키를 설정합니다.
SetPublicKeyToken(Byte[])	애플리케이션 또는 어셈블리가 서명된 공개 키의 SHA-1 해시의 마지막 8바이트인 공개 키 토큰을 설정합니다.
ToString()	표시 이름이라고도 하는 어셈블리의 전체 이름을 반환합니다.

추가 정보

• Version
• GetPublicKey()
• GetPublicKeyToken()
• SetPublicKey(Byte[])
• SetPublicKeyToken(Byte[])
• FullName
• GetType()
• AssemblyQualifiedName
• 정규화된 형식 이름 지정