Assembly Sınıf

Tanım

public ref class Assembly abstract

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider

public ref class Assembly : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public abstract class Assembly

public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable

public abstract class Assembly : System.Reflection.ICustomAttributeProvider

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

type Assembly = class

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

type Assembly = class
    interface ICustomAttributeProvider

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider

Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Public MustInherit Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Devralma

Object

Assembly

Türetilmiş

System.Reflection.Emit.AssemblyBuilder

Öznitelikler

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Uygulamalar

ICustomAttributeProvider ISerializable _Assembly IEvidenceFactory

Ö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

Özellikler

Yöntemler

İşleçler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

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

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

Ayrıca bkz.

• AppDomain
• AssemblyName
• Uygulama Etki Alanları