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 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, SampleMethodadlı bir yöntemle Exampleadlı bir 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ı kabul eder.

Kod örneği, derlemenin tam adını ayrıştırmak için kullanılabilecek bir AssemblyName nesnesi elde etmek için GetName 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

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

Bir uygulama etki alanına (örneğin, basit bir projenin varsayılan uygulama etki alanı) yüklenmiş derlemeleri temsil eden Assembly nesneleri dizisi almak için AppDomain.GetAssemblies yöntemini kullanın.

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

• Derlemeleri yüklemenin önerilen yolu, derlemenin görünen adıyla yükleneceğini tanımlayan Load yöntemini kullanmaktır (örneğin, "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). Derleme araması, çalışma zamanının derlemeleri nasılbulma bölümünde açıklanan kurallara uyar.

• ReflectionOnlyLoad ve ReflectionOnlyLoadFrom yöntemleri, bir derlemeyi yansıma için yüklemenize olanak tanır, ancak yürütme için yüklemez. Örneğin, 64 bit platformu hedefleyen bir derleme, 32 bit platformda çalışan kod tarafından incelenebilir.

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

Şu anda yürütülen derleme için bir Assembly nesnesi almak için GetExecutingAssembly yöntemini kullanın.

Assembly sınıfının birçok üyesi bir derleme hakkında bilgi sağlar. Mesela:

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

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

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

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

GetTypes yöntemi, derlemedeki tüm türleri listeler. GetExportedTypes yöntemi, derleme dışındaki çağıranlar tarafından görülebilen türleri listeler. GetType yöntemi, derlemedeki 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 nesnesinde başlangıçta belirtildiği gibi alır.
CustomAttributes	Bu derlemenin özel özniteliklerini içeren bir koleksiyon 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 koleksiyon AssemblyLoadContexttutulup tutulmadığını gösteren 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 gösteren 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 koleksiyon alır.
ReflectionOnly	Bu derlemenin yalnızca yansıma bağlamı içine yüklenip yüklenmediğini belirten bir Boolean değeri 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 ve 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 nitelenmiş bir 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ığı yüklü derlemeyi alır.
GetCallingAssembly()	Şu anda yürütülen yöntemi çağıran yöntemin Assembly döndürür.
GetCustomAttributes(Boolean)	Bu derleme için tüm özel öznitelikleri alır.
GetCustomAttributes(Type, Boolean)	Türe göre belirtilen bu derleme için özel öznitelikleri alır.
GetCustomAttributesData()	geçerli Assemblyuygulanan öznitelikler hakkında CustomAttributeData nesneler olarak ifade edilen bilgileri döndürür.
GetEntryAssembly()	Çalışan uygulama için giriş derlemesini alı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 ortak türleri alır.
GetFile(String)	Bu derlemenin 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 derlemeyi temsil eder.
GetHashCode()	Bu örneğin karma kodunu döndürür.
GetLoadedModules()	Bu derlemenin parçası olan tüm yüklü 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)	Kod tabanını copiedNametarafından belirtilen şekilde 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()	Bu derleme tarafından başvuruda bulunılan tüm derlemeler için AssemblyName 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetType(String)	Derleme örneğinde belirtilen ada sahip Type nesnesini alır.
GetType(String, Boolean)	Derleme örneğinde belirtilen ada sahip Type nesnesini alır ve tür bulunamazsa isteğe bağlı olarak bir özel durum oluşturur.
GetType(String, Boolean, Boolean)	Büyük/küçük harf yoksayma ve tür bulunamazsa özel durum oluşturma seçenekleriyle derleme örneğinde belirtilen ada sahip Type nesnesini alır.
GetTypes()	Bu derlemede tanımlanan tüm türleri alır.
IsDefined(Type, Boolean)	Belirtilen bir özniteliğin derlemeye uygulanıp uygulanmadığını gösterir.
Load(AssemblyName)	AssemblyNameverilen bir derlemeyi yükler.
Load(Byte[])	Derlemeyi, yayılan bir derleme içeren ortak nesne dosyası 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ı verilen bir derlemeyi 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ı bir 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ı bir görüntüyle yükler. Modülün simgelerini temsil eden ham baytlar da yüklenir.
LoadWithPartialName(String)	Geçersiz. Uygulama dizininden veya kısmi bir ad kullanarak genel derleme önbelleğinden bir derleme yükler.
MemberwiseClone()	Geçerli Objectbasit 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ı 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. Görüntü adı verilen bir derlemeyi 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ük bağlama yükler.

İşleçler

Equality(Assembly, Assembly)	İki Assembly nesnesinin eşit olup olmadığını gösterir.
Inequality(Assembly, Assembly)	İki Assembly nesnesinin 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 yapılan başvuruyu normal yollarla çözümleyemediğinde gerçekleşir.

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 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 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 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 bir derlemeye uygulanan özel öznitelik koleksiyonunu 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ürde özel özniteliklerin belirtilen bir derlemeye uygulanıp uygulanmadığını gösterir.
TryGetRawMetadata(Assembly, Byte*, Int32)	MetadataReaderile kullanmak üzere derlemenin meta veri bölümünü alır.

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

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

Ayrıca bkz.

• AppDomain
• AssemblyName
• Uygulama Etki Alanları