Assembly Kelas

Definisi

Ruang nama:

System.Reflection

Rakitan:

System.Runtime.dll

Sumber:

Assembly.cs

Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat diverifikasi, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.

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

Warisan

Object

Assembly

Turunan

System.Reflection.Emit.AssemblyBuilder

Penerapan

ICustomAttributeProvider ISerializable

Contoh

Contoh kode berikut menunjukkan cara mendapatkan rakitan yang sedang dijalankan, membuat instans jenis yang terkandung dalam rakitan tersebut, dan memanggil salah satu metode jenis dengan pengikatan terlambat. Untuk tujuan ini, contoh kode menentukan kelas bernama Example, dengan metode bernama SampleMethod. Konstruktor kelas menerima bilangan bulat, yang digunakan untuk menghitung nilai pengembalian metode.

Contoh kode juga menunjukkan penggunaan metode GetName untuk mendapatkan objek AssemblyName yang dapat digunakan untuk mengurai nama lengkap rakitan. Contoh menampilkan nomor versi rakitan, properti CodeBase, dan properti 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()
'

Keterangan

Gunakan kelas Assembly untuk memuat rakitan, untuk menjelajahi metadata dan bagian konstituen rakitan, untuk menemukan jenis yang terkandung dalam rakitan, dan untuk membuat instans jenis tersebut.

Untuk mendapatkan array objek Assembly yang mewakili rakitan yang saat ini dimuat ke dalam domain aplikasi (misalnya, domain aplikasi default proyek sederhana), gunakan metode AppDomain.GetAssemblies.

Untuk memuat rakitan secara dinamis, kelas Assembly menyediakan metode statis berikut ( metodeShared di Visual Basic). Rakitan dimuat ke dalam domain aplikasi tempat operasi beban terjadi.

• Cara yang disarankan untuk memuat rakitan adalah dengan menggunakan metode Load, yang mengidentifikasi rakitan yang akan dimuat dengan nama tampilannya (misalnya, "System.Windows.Forms, Version=2.0.0.0, Culture=netral, PublicKeyToken=b77a5c561934e089"). Pencarian rakitan mengikuti aturan yang dijelaskan dalam Bagaimana Runtime Menemukan Rakitan.

• Metode ReflectionOnlyLoad dan ReflectionOnlyLoadFrom memungkinkan Anda memuat rakitan untuk refleksi, tetapi tidak untuk eksekusi. Misalnya, rakitan yang menargetkan platform 64-bit dapat diperiksa oleh kode yang berjalan pada platform 32-bit.

• Metode LoadFile dan LoadFrom disediakan untuk skenario langka di mana rakitan harus diidentifikasi berdasarkan jalur.

Untuk mendapatkan objek Assembly untuk rakitan yang sedang dijalankan, gunakan metode GetExecutingAssembly.

Banyak anggota kelas Assembly memberikan informasi tentang perakitan. Misalnya:

• Metode GetName mengembalikan objek AssemblyName yang menyediakan akses ke bagian nama tampilan rakitan.

• Metode GetCustomAttributes mencantumkan atribut yang diterapkan ke rakitan.

• Metode GetFiles menyediakan akses ke file dalam manifes perakitan.

• Metode GetManifestResourceNames menyediakan nama sumber daya dalam manifes perakitan.

Metode GetTypes mencantumkan semua jenis dalam rakitan. Metode GetExportedTypes mencantumkan jenis yang terlihat oleh penelepon di luar rakitan. Metode GetType dapat digunakan untuk mencari jenis tertentu dalam rakitan. Metode CreateInstance dapat digunakan untuk mencari dan membuat instans jenis dalam perakitan.

Untuk informasi selengkapnya tentang rakitan, lihat bagian "Domain Aplikasi dan Rakitan" di topik Domain Aplikasi .

Konstruktor

Assembly()

Menginisialisasi instans baru kelas Assembly.

Properti

CodeBase	Kedaluwarsa. Mendapatkan lokasi rakitan seperti yang ditentukan awalnya, misalnya, dalam objek AssemblyName.
CustomAttributes	Mendapatkan koleksi yang berisi atribut kustom assembly ini.
DefinedTypes	Mendapatkan koleksi jenis yang ditentukan dalam rakitan ini.
EntryPoint	Mendapatkan titik masuk dari rakitan ini.
EscapedCodeBase	Kedaluwarsa. Mendapatkan URI, termasuk karakter escape, yang mewakili basis kode.
ExportedTypes	Mendapatkan kumpulan jenis publik yang ditentukan dalam rakitan ini yang terlihat di luar rakitan.
FullName	Mendapatkan nama tampilan rakitan.
GlobalAssemblyCache	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah assembly dimuat dari cache assembly global (hanya.NET Framework).
HostContext	Mendapatkan konteks host tempat assembly dimuat.
ImageRuntimeVersion	Mendapatkan string yang mewakili versi runtime bahasa umum (CLR) yang disimpan dalam file yang berisi manifes.
IsCollectible	Mendapatkan nilai yang menunjukkan apakah rakitan ini disimpan dalam AssemblyLoadContextyang dapat dikumpulkan .
IsDynamic	Mendapatkan nilai yang menunjukkan apakah rakitan saat ini dihasilkan secara dinamis dalam proses saat ini dengan menggunakan pancaran pantulan.
IsFullyTrusted	Mendapatkan nilai yang menunjukkan apakah rakitan saat ini dimuat dengan kepercayaan penuh.
Location	Mendapatkan jalur lengkap atau lokasi UNC dari file yang dimuat yang berisi manifes.
ManifestModule	Mendapatkan modul yang berisi manifes untuk rakitan saat ini.
Modules	Mendapatkan koleksi yang berisi modul dalam rakitan ini.
ReflectionOnly	Mendapatkan nilai Boolean yang menunjukkan apakah rakitan ini dimuat ke dalam konteks khusus pantulan.
SecurityRuleSet	Mendapatkan nilai yang menunjukkan kumpulan aturan keamanan mana yang diterapkan runtime bahasa umum (CLR) untuk rakitan ini.

Metode

CreateInstance(String)	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, menggunakan pencarian peka huruf besar/kecil.
CreateInstance(String, Boolean)	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, dengan pencarian peka huruf besar/kecil opsional.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, dengan pencarian peka huruf besar/kecil opsional dan memiliki kultur, argumen, dan atribut pengikatan dan aktivasi yang ditentukan.
CreateQualifiedName(String, String)	Membuat nama jenis yang memenuhi syarat dengan nama tampilan rakitannya.
Equals(Object)	Menentukan apakah rakitan ini dan objek yang ditentukan sama.
GetAssembly(Type)	Mendapatkan rakitan yang saat ini dimuat di mana jenis yang ditentukan ditentukan.
GetCallingAssembly()	Mengembalikan Assembly metode yang memanggil metode yang sedang dijalankan.
GetCustomAttributes(Boolean)	Mendapatkan semua atribut kustom untuk rakitan ini.
GetCustomAttributes(Type, Boolean)	Mendapatkan atribut kustom untuk rakitan ini seperti yang ditentukan oleh jenis.
GetCustomAttributesData()	Mengembalikan informasi tentang atribut yang telah diterapkan ke Assemblysaat ini , yang dinyatakan sebagai objek CustomAttributeData.
GetEntryAssembly()	Mendapatkan rakitan entri untuk aplikasi yang sedang berjalan.
GetExecutingAssembly()	Mendapatkan rakitan yang berisi kode yang sedang dijalankan.
GetExportedTypes()	Mendapatkan jenis publik yang ditentukan dalam rakitan ini yang terlihat di luar rakitan.
GetFile(String)	Mendapatkan FileStream untuk file yang ditentukan dalam tabel file manifes perakitan ini.
GetFiles()	Mendapatkan file dalam tabel file manifes perakitan.
GetFiles(Boolean)	Mendapatkan file dalam tabel file manifes perakitan, menentukan apakah akan menyertakan modul sumber daya.
GetForwardedTypes()	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat diverifikasi, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetHashCode()	Mengembalikan kode hash untuk instans ini.
GetLoadedModules()	Mendapatkan semua modul yang dimuat yang merupakan bagian dari rakitan ini.
GetLoadedModules(Boolean)	Mendapatkan semua modul yang dimuat yang merupakan bagian dari perakitan ini, menentukan apakah akan menyertakan modul sumber daya.
GetManifestResourceInfo(String)	Mengembalikan informasi tentang bagaimana sumber daya yang diberikan telah dipertahankan.
GetManifestResourceNames()	Mengembalikan nama semua sumber daya dalam rakitan ini.
GetManifestResourceStream(String)	Memuat sumber daya manifes yang ditentukan dari rakitan ini.
GetManifestResourceStream(Type, String)	Memuat sumber daya manifes yang ditentukan, yang dicakup oleh namespace dari jenis yang ditentukan, dari rakitan ini.
GetModule(String)	Mendapatkan modul yang ditentukan dalam rakitan ini.
GetModules()	Mendapatkan semua modul yang merupakan bagian dari perakitan ini.
GetModules(Boolean)	Mendapatkan semua modul yang merupakan bagian dari perakitan ini, menentukan apakah akan menyertakan modul sumber daya.
GetName()	Mendapatkan AssemblyName untuk rakitan ini.
GetName(Boolean)	Mendapatkan AssemblyName untuk rakitan ini, mengatur basis kode seperti yang ditentukan oleh copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Mendapatkan informasi serialisasi dengan semua data yang diperlukan untuk menginstansiasi kembali perakitan ini.
GetReferencedAssemblies()	Mendapatkan objek AssemblyName untuk semua rakitan yang dirujuk oleh rakitan ini.
GetSatelliteAssembly(CultureInfo)	Mendapatkan rakitan satelit untuk budaya yang ditentukan.
GetSatelliteAssembly(CultureInfo, Version)	Mendapatkan versi rakitan satelit yang ditentukan untuk budaya yang ditentukan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetType(String)	Mendapatkan objek Type dengan nama yang ditentukan dalam instans rakitan.
GetType(String, Boolean)	Mendapatkan objek Type dengan nama yang ditentukan dalam instans rakitan dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan.
GetType(String, Boolean, Boolean)	Mendapatkan objek Type dengan nama yang ditentukan dalam instans rakitan, dengan opsi mengabaikan kasus, dan melemparkan pengecualian jika jenisnya tidak ditemukan.
GetTypes()	Mendapatkan semua jenis yang ditentukan dalam rakitan ini.
IsDefined(Type, Boolean)	Menunjukkan apakah atribut yang ditentukan telah diterapkan ke rakitan atau tidak.
Load(AssemblyName)	Memuat rakitan yang diberikan AssemblyName.
Load(Byte[])	Memuat rakitan dengan gambar berbasis format file objek umum (COFF) yang berisi rakitan yang dipancarkan.
Load(Byte[], Byte[])	Memuat rakitan dengan gambar berbasis format file objek umum (COFF) yang berisi rakitan yang dipancarkan, secara opsional termasuk simbol untuk rakitan.
Load(String)	Memuat rakitan dengan nama yang ditentukan.
LoadFile(String)	Memuat konten file rakitan pada jalur yang ditentukan.
LoadFrom(String)	Memuat rakitan yang diberikan nama atau jalur filenya.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Memuat rakitan yang diberikan nama file atau jalurnya, nilai hash, dan algoritma hash.
LoadModule(String, Byte[])	Memuat modul, internal ke rakitan ini, dengan gambar berbasis format file objek umum (COFF) yang berisi modul yang dipancarkan, atau file sumber daya.
LoadModule(String, Byte[], Byte[])	Memuat modul, internal ke rakitan ini, dengan gambar berbasis format file objek umum (COFF) yang berisi modul yang dipancarkan, atau file sumber daya. Byte mentah yang mewakili simbol untuk modul juga dimuat.
LoadWithPartialName(String)	Kedaluwarsa. Memuat rakitan dari direktori aplikasi atau dari cache perakitan global menggunakan nama parsial.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ReflectionOnlyLoad(Byte[])	Kedaluwarsa. Memuat rakitan dari gambar berbasis format file objek umum (COFF) yang berisi rakitan yang dipancarkan. Rakitan dimuat ke dalam konteks refleksi-saja dari domain aplikasi pemanggil.
ReflectionOnlyLoad(String)	Kedaluwarsa. Memuat rakitan ke dalam konteks khusus pantulan, mengingat nama tampilannya.
ReflectionOnlyLoadFrom(String)	Kedaluwarsa. Memuat rakitan ke dalam konteks khusus refleksi, mengingat jalurnya.
ToString()	Mengembalikan nama lengkap rakitan, juga dikenal sebagai nama tampilan.
UnsafeLoadFrom(String)	Memuat rakitan ke dalam konteks load-from, melewati beberapa pemeriksaan keamanan.

Operator

Equality(Assembly, Assembly)	Menunjukkan apakah dua objek Assembly sama.
Inequality(Assembly, Assembly)	Menunjukkan apakah dua objek Assembly tidak sama.

Acara

ModuleResolve

Terjadi ketika pemuat kelas runtime bahasa umum tidak dapat menyelesaikan referensi ke modul internal perakitan melalui cara normal.

Metode Ekstensi

GetExportedTypes(Assembly)	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat diverifikasi, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetModules(Assembly)	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat diverifikasi, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetTypes(Assembly)	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat diverifikasi, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetCustomAttribute(Assembly, Type)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttribute<T>(Assembly)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttributes(Assembly)	Mengambil kumpulan atribut kustom yang diterapkan ke rakitan tertentu.
GetCustomAttributes(Assembly, Type)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttributes<T>(Assembly)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
IsDefined(Assembly, Type)	Menunjukkan apakah atribut kustom dari jenis tertentu diterapkan ke rakitan tertentu.
TryGetRawMetadata(Assembly, Byte*, Int32)	Mengambil bagian metadata dari rakitan, untuk digunakan dengan MetadataReader.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• AppDomain
• AssemblyName
• Domain Aplikasi