Assembly Sınıf

Tanım

Ad Alanı:

System.Reflection

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Assembly.cs

Ortak dil çalışma zamanı uygulamasının yeniden kullanılabilir, sürümlenebilir ve kendi kendini açıklayan yapı taşı olan bir derlemeyi temsil eder.

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

Devralma

Object

Assembly

Türetilmiş

System.Reflection.Emit.AssemblyBuilder

Uygulamalar

ICustomAttributeProvider ISerializable

Örnekler

Aşağıdaki kod örneği, şu anda yürütülen derlemenin nasıl alınacağını, bu derlemede bulunan bir türün örneğini oluşturmayı ve türün yöntemlerinden birini geç bağlama ile çağırmayı gösterir. Bu amaçla, kod örneği adlı bir yöntemle SampleMethodadlı Examplebir sınıf tanımlar. sınıfının oluşturucu, yönteminin dönüş değerini hesaplamak için kullanılan bir tamsayıyı kabul eder.

Kod örneği, derlemenin GetName tam adını ayrıştırmak için kullanılabilecek bir AssemblyName nesne elde etmek için yönteminin kullanımını da gösterir. Örnekte derlemenin sürüm numarası, CodeBase özelliği ve EntryPoint özelliği görüntülenir.

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

Açıklamalar

Assembly Derlemeleri yüklemek, derlemelerin meta verilerini ve bileşenlerini keşfetmek, derlemelerde bulunan türleri bulmak ve bu türlerin örneklerini oluşturmak için sınıfını kullanın.

Şu anda bir uygulama etki alanına yüklenen derlemeleri temsil eden bir nesne dizisi Assembly almak için (örneğin, basit bir projenin varsayılan uygulama etki alanı), yöntemini kullanın AppDomain.GetAssemblies .

Derlemeleri dinamik olarak yüklemek için sınıfı Assembly aşağıdaki statik yöntemleri (Shared Visual Basic'teki yöntemler) sağlar. Derlemeler, yükleme işleminin gerçekleştiği uygulama etki alanına yüklenir.

• Derlemeleri yüklemenin önerilen yolu, derlemenin Load görünen adıyla yükleneceğini tanımlayan yöntemini kullanmaktır (örneğin, "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). Derleme araması , Çalışma Zamanı Derlemeleri Nasıl Bulur başlığında açıklanan kurallara uyar.

• ReflectionOnlyLoad ve ReflectionOnlyLoadFrom yöntemleri, yansıma için bir derleme yüklemenizi sağlar, ancak yürütme için yüklemenizi sağlamaz. Örneğin, 64 bit platformu hedefleyen bir derleme, 32 bitlik bir platformda çalışan kod tarafından incelenebilir.

• ve LoadFrom yöntemleri, bir derlemenin LoadFile yol tarafından tanımlanması gereken nadir senaryolar için sağlanır.

Şu anda yürütülmekte olan derlemenin nesnesini Assembly almak için yöntemini kullanın GetExecutingAssembly .

Sınıfın Assembly birçok üyesi bir derleme hakkında bilgi sağlar. Örnek:

• yöntemi, GetName derleme görünen adının bölümlerine erişim sağlayan bir AssemblyName nesne döndürür.

• yöntemi, GetCustomAttributes derlemeye uygulanan öznitelikleri listeler.

• yöntemi, GetFiles derleme bildirimindeki dosyalara erişim sağlar.

• yöntemi, GetManifestResourceNames derleme bildirimindeki kaynakların adlarını sağlar.

yöntemi, GetTypes derlemedeki tüm türleri listeler. yöntemi, GetExportedTypes derleme dışındaki çağıranlar tarafından görülebilen türleri listeler. GetType yöntemi, derlemede belirli bir türü aramak için kullanılabilir. CreateInstance yöntemi, derlemedeki tür örneklerini aramak ve oluşturmak için kullanılabilir.

Derlemeler hakkında daha fazla bilgi için, Uygulama Etki Alanları konusunun " Uygulama Etki Alanları ve Derlemeler" bölümüne bakın.

Oluşturucular

Assembly()

Assembly sınıfının yeni bir örneğini başlatır.

Özellikler

CodeBase	Geçersiz. Derlemenin konumunu, örneğin bir AssemblyName nesnede başlangıçta belirtildiği şekilde alır.
CustomAttributes	Bu derlemenin özel özniteliklerini içeren bir koleksiyonu alır.
DefinedTypes	Bu derlemede tanımlanan türlerin koleksiyonunu alır.
EntryPoint	Bu derlemenin giriş noktasını alır.
EscapedCodeBase	Geçersiz. Kod tabanını temsil eden kaçış karakterleri de dahil olmak üzere URI'yi alır.
ExportedTypes	Bu derlemede tanımlanan ve derleme dışında görünen ortak türlerin koleksiyonunu alır.
FullName	Derlemenin görünen adını alır.
GlobalAssemblyCache	Geçersiz. Derlemenin genel derleme önbelleğinden yüklenip yüklenmediğini belirten bir değer alır (yalnızca .NET Framework).
HostContext	Derlemenin yüklendiği konak bağlamını alır.
ImageRuntimeVersion	Bildirimi içeren dosyaya kaydedilen ortak dil çalışma zamanının (CLR) sürümünü temsil eden bir dize alır.
IsCollectible	Bu derlemenin bir collectible AssemblyLoadContextiçinde tutulup tutulmadığını belirten bir değer alır.
IsDynamic	Geçerli derlemenin yansıma yayma kullanılarak geçerli işlemde dinamik olarak oluşturulup oluşturulmadığını gösteren bir değer alır.
IsFullyTrusted	Geçerli derlemenin tam güvenle yüklenip yüklenmediğini belirten bir değer alır.
Location	Bildirimi içeren yüklenen dosyanın tam yolunu veya UNC konumunu alır.
ManifestModule	Geçerli derlemenin bildirimini içeren modülü alır.
Modules	Bu derlemedeki modülleri içeren bir koleksiyonu alır.
ReflectionOnly	Bu derlemenin yalnızca yansıma bağlamı içine yüklenip yüklenmediğini belirten bir Boolean değer alır.
SecurityRuleSet	Ortak dil çalışma zamanının (CLR) bu derleme için hangi güvenlik kuralları kümesini zorunlu kıldığını gösteren bir değer alır.

Yöntemler

CreateInstance(String)	Belirtilen türü bu derlemeden bulur ve büyük/küçük harfe duyarlı arama kullanarak sistem etkinleştiricisini kullanarak bir örneğini oluşturur.
CreateInstance(String, Boolean)	Belirtilen türü bu derlemeden bulur ve isteğe bağlı büyük/küçük harfe duyarlı arama ile sistem etkinleştiricisini kullanarak bir örneğini oluşturur.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Bu derlemeden belirtilen türü bulur ve isteğe bağlı büyük/küçük harfe duyarlı arama ve belirtilen kültüre, bağımsız değişkenlere, bağlama ve etkinleştirme özniteliklerine sahip sistem etkinleştiricisini kullanarak bunun bir örneğini oluşturur.
CreateQualifiedName(String, String)	Derlemesinin görünen adıyla nitelenen türün adını oluşturur.
Equals(Object)	Bu derlemenin ve belirtilen nesnenin eşit olup olmadığını belirler.
GetAssembly(Type)	Belirtilen türün tanımlandığı şu anda yüklü olan derlemeyi alır.
GetCallingAssembly()	Assembly Şu anda yürütülmekte olan yöntemi çağıran yöntemin değerini döndürür.
GetCustomAttributes(Boolean)	Bu derleme için tüm özel öznitelikleri alır.
GetCustomAttributes(Type, Boolean)	Türe göre belirtilen şekilde bu derleme için özel öznitelikleri alır.
GetCustomAttributesData()	Nesne olarak CustomAttributeData ifade edilen geçerli Assemblyöğesine uygulanmış olan öznitelikler hakkındaki bilgileri döndürür.
GetEntryAssembly()	İşlem yürütülebilir dosyasını varsayılan uygulama etki alanında alır. Diğer uygulama etki alanlarında, bu tarafından ExecuteAssembly(String)yürütülen ilk yürütülebilir dosyadır.
GetExecutingAssembly()	Şu anda yürütülmekte olan kodu içeren derlemeyi alır.
GetExportedTypes()	Bu derlemede tanımlanan ve derleme dışında görünen genel türleri alır.
GetFile(String)	Bu derleme bildiriminin dosya tablosunda belirtilen dosya için bir FileStream alır.
GetFiles()	Derleme bildiriminin dosya tablosundaki dosyaları alır.
GetFiles(Boolean)	Bir derleme bildiriminin dosya tablosundaki dosyaları alır ve kaynak modüllerinin dahil edilip edilmeyeceğini belirtir.
GetForwardedTypes()	Ortak dil çalışma zamanı uygulamasının yeniden kullanılabilir, sürümlenebilir ve kendi kendini açıklayan yapı taşı olan bir derlemeyi temsil eder.
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür.
GetLoadedModules()	Bu derlemenin parçası olan tüm yüklenen modülleri alır.
GetLoadedModules(Boolean)	Kaynak modüllerinin dahil edilip edilmeyeceğini belirterek bu derlemenin parçası olan tüm yüklü modülleri alır.
GetManifestResourceInfo(String)	Verilen kaynağın nasıl kalıcı hale getirildiği hakkında bilgi döndürür.
GetManifestResourceNames()	Bu derlemedeki tüm kaynakların adlarını döndürür.
GetManifestResourceStream(String)	Belirtilen bildirim kaynağını bu derlemeden yükler.
GetManifestResourceStream(Type, String)	Bu derlemeden belirtilen türün ad alanı tarafından kapsamı belirlenmiş belirtilen bildirim kaynağını yükler.
GetModule(String)	Bu derlemede belirtilen modülü alır.
GetModules()	Bu derlemenin parçası olan tüm modülleri alır.
GetModules(Boolean)	Kaynak modüllerinin dahil edilip edilmeyeceğini belirterek bu derlemenin parçası olan tüm modülleri alır.
GetName()	Bu derleme için bir AssemblyName alır.
GetName(Boolean)	Tarafından belirtilen copiedNamekod tabanını ayarlayarak bu derleme için bir AssemblyName alır.
GetObjectData(SerializationInfo, StreamingContext)	Geçersiz. Bu derlemeyi yeniden doğrulamak için gereken tüm verilerle serileştirme bilgilerini alır.
GetReferencedAssemblies()	AssemblyName Bu derleme tarafından başvuruda bulunılan tüm derlemelerin nesnelerini alır.
GetSatelliteAssembly(CultureInfo)	Belirtilen kültür için uydu derlemesini alır.
GetSatelliteAssembly(CultureInfo, Version)	Belirtilen kültür için uydu derlemesinin belirtilen sürümünü alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetType(String)	Type Derleme örneğinde belirtilen ada sahip nesnesini alır.
GetType(String, Boolean)	Type Derleme örneğinde belirtilen ada sahip nesnesini alır ve tür bulunamazsa isteğe bağlı olarak bir özel durum oluşturur.
GetType(String, Boolean, Boolean)	Type Büyük/küçük harf yoksayma ve tür bulunamazsa özel durum oluşturma seçenekleriyle derleme örneğinde belirtilen ada sahip nesneyi alır.
GetTypes()	Bu derlemede tanımlanan tüm türleri alır.
IsDefined(Type, Boolean)	Belirtilen özniteliğin derlemeye uygulanıp uygulanmadığını gösterir.
Load(AssemblyName)	verilen bir derlemeyi AssemblyNameyükler.
Load(Byte[])	Derlemeyi, yayılan bir derleme içeren ortak nesne dosya biçimi (COFF) tabanlı bir görüntüyle yükler.
Load(Byte[], Byte[])	Derlemeyi, isteğe bağlı olarak derleme için simgeler de dahil olmak üzere, yayılan bir derleme içeren ortak nesne dosya biçimi (COFF) tabanlı bir görüntüyle yükler.
Load(String)	Belirtilen ada sahip bir derleme yükler.
LoadFile(String)	Belirtilen yola bir derleme dosyasının içeriğini yükler.
LoadFrom(String)	Dosya adı veya yolu verilen bir derlemeyi yükler.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Dosya adı veya yolu, karma değeri ve karma algoritmasına göre bir derleme yükler.
LoadModule(String, Byte[])	Bu derlemenin içindeki modülü, yayılan bir modülü veya kaynak dosyasını içeren ortak nesne dosyası biçimi (COFF) tabanlı görüntüyle yükler.
LoadModule(String, Byte[], Byte[])	Bu derlemenin içindeki modülü, yayılan bir modülü veya kaynak dosyasını içeren ortak nesne dosyası biçimi (COFF) tabanlı görüntüyle yükler. Modül simgelerini temsil eden ham baytlar da yüklenir.
LoadWithPartialName(String)	Geçersiz. Uygulama dizininden veya kısmi bir ad kullanarak genel bütünleştirilmiş kod önbelleğinden bir derleme yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ReflectionOnlyLoad(Byte[])	Geçersiz. Derlemeyi, yayılan bir derleme içeren ortak nesne dosya biçimi (COFF) tabanlı bir görüntüden yükler. Derleme, çağıranın uygulama etki alanının yalnızca yansıma bağlamı içine yüklenir.
ReflectionOnlyLoad(String)	Geçersiz. Bir derlemeyi, görünen adı verilip yalnızca yansıma bağlamı içine yükler.
ReflectionOnlyLoadFrom(String)	Geçersiz. Yolu dikkate alındığında, bir derlemeyi yalnızca yansıma bağlamı içine yükler.
ToString()	Derlemenin görünen adı olarak da bilinen tam adını döndürür.
UnsafeLoadFrom(String)	Bazı güvenlik denetimlerini atlayarak bir derlemeyi yükten bağlama yükler.

İşleçler

Equality(Assembly, Assembly)	İki Assembly nesnenin eşit olup olmadığını gösterir.
Inequality(Assembly, Assembly)	İki Assembly nesnenin eşit olup olmadığını gösterir.

Ekinlikler

ModuleResolve

Ortak dil çalışma zamanı sınıf yükleyicisi bir derlemenin iç modülüne yönelik başvuruyu normal yollarla çözümleyemediğinde oluşur.

Uzantı Metotları

GetExportedTypes(Assembly)	Ortak dil çalışma zamanı uygulamasının yeniden kullanılabilir, sürümlenebilir ve kendi kendini açıklayan yapı taşı olan bir derlemeyi temsil eder.
GetModules(Assembly)	Ortak dil çalışma zamanı uygulamasının yeniden kullanılabilir, sürümlenebilir ve kendi kendini açıklayan yapı taşı olan bir derlemeyi temsil eder.
GetTypes(Assembly)	Ortak dil çalışma zamanı uygulamasının yeniden kullanılabilir, sürümlenebilir ve kendi kendini açıklayan yapı taşı olan bir derlemeyi temsil eder.
GetCustomAttribute(Assembly, Type)	Belirtilen bir derlemeye uygulanan belirtilen türde bir özel özniteliği alır.
GetCustomAttribute<T>(Assembly)	Belirtilen bir derlemeye uygulanan belirtilen türde bir özel özniteliği alır.
GetCustomAttributes(Assembly)	Belirtilen derlemeye uygulanan özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes(Assembly, Type)	Belirtilen bir derlemeye uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes<T>(Assembly)	Belirtilen bir derlemeye uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
IsDefined(Assembly, Type)	Belirtilen türlerdeki özel özniteliklerin belirtilen bir derlemeye uygulanıp uygulanmadığını gösterir.
TryGetRawMetadata(Assembly, Byte*, Int32)	ile MetadataReaderkullanmak üzere derlemenin meta veri bölümünü alır.

İş Parçacığı Güvenliği

Bu güvenli iş parçacığı türüdür.

Ayrıca bkz.

• AppDomain
• AssemblyName
• Uygulama Etki Alanları