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 digunakan kembali, 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 saat ini dijalankan, membuat instans jenis yang terkandung dalam rakitan tersebut, dan memanggil salah satu metode jenis dengan pengikatan terlambat. Untuk tujuan ini, contoh kode mendefinisikan kelas bernama Example, dengan metode bernama SampleMethod. Konstruktor kelas menerima bilangan bulat, yang digunakan untuk menghitung nilai pengembalian metode.

Contoh kode juga menunjukkan penggunaan GetName metode untuk mendapatkan AssemblyName objek yang dapat digunakan untuk mengurai nama lengkap assembly. Contoh menampilkan nomor versi assembly, CodeBase properti , dan EntryPoint properti .

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

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

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

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

• Cara yang disarankan untuk memuat rakitan adalah dengan menggunakan Load metode , 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 Cara Runtime Menemukan Rakitan.

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

• Metode LoadFile dan LoadFrom disediakan untuk skenario langka di mana perakitan harus diidentifikasi dengan jalur.

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

Banyak anggota Assembly kelas memberikan informasi tentang perakitan. Contohnya:

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

• Metode ini GetCustomAttributes mencantumkan atribut yang diterapkan ke assembly.

• Metode ini GetFiles menyediakan akses ke file dalam manifes perakitan.

• Metode ini GetManifestResourceNames menyediakan nama sumber daya dalam manifes perakitan.

Metode ini GetTypes mencantumkan semua jenis dalam rakitan. Metode ini GetExportedTypes mencantumkan jenis yang terlihat oleh penelepon di luar perakitan. Metode GetType ini dapat digunakan untuk mencari jenis tertentu dalam perakitan. Metode CreateInstance ini dapat digunakan untuk mencari dan membuat instans jenis di 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 AssemblyName objek.
CustomAttributes	Mendapatkan koleksi yang berisi atribut kustom assembly ini.
DefinedTypes	Mendapatkan kumpulan jenis yang ditentukan dalam rakitan ini.
EntryPoint	Mendapatkan titik masuk dari assembly 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 perakitan.
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 assembly ini ditahan dalam collectible AssemblyLoadContext.
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 assembly saat ini.
Modules	Mendapatkan koleksi yang berisi modul dalam rakitan ini.
ReflectionOnly	Mendapatkan nilai yang Boolean menunjukkan apakah rakitan ini dimuat ke dalam konteks khusus refleksi.
SecurityRuleSet	Mendapatkan nilai yang menunjukkan sekumpulan aturan keamanan mana yang diterapkan runtime bahasa umum (CLR) untuk perakitan 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 budaya, 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 saat ini 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 saat ini , yang dinyatakan Assemblysebagai CustomAttributeData objek.
GetEntryAssembly()	Mendapatkan proses yang dapat dieksekusi di domain aplikasi default. Di domain aplikasi lain, ini adalah executable pertama yang dijalankan oleh ExecuteAssembly(String).
GetExecutingAssembly()	Mendapatkan rakitan yang berisi kode yang saat ini dijalankan.
GetExportedTypes()	Mendapatkan jenis publik yang ditentukan dalam rakitan ini yang terlihat di luar perakitan.
GetFile(String)	FileStream Mendapatkan 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 digunakan kembali, 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 perakitan 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()	AssemblyName Mendapatkan untuk rakitan ini.
GetName(Boolean)	AssemblyName Mendapatkan 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()	AssemblyName Mendapatkan objek 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 instans Type saat ini. (Diperoleh dari Object)
GetType(String)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly.
GetType(String, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan.
GetType(String, Boolean, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly, 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 tertentu telah diterapkan ke assembly atau tidak.
Load(AssemblyName)	Memuat assembly 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 perakitan.
Load(String)	Memuat rakitan dengan nama yang ditentukan.
LoadFile(String)	Memuat isi file assembly pada jalur yang ditentukan.
LoadFrom(String)	Memuat rakitan yang diberi nama atau jalur filenya.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Memuat rakitan yang diberi nama atau jalur file, nilai hash, dan algoritma hash.
LoadModule(String, Byte[])	Memuat modul, internal ke assembly 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 assembly 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 yang saat ini Object. (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 hanya refleksi dari domain aplikasi pemanggil.
ReflectionOnlyLoad(String)	Kedaluwarsa. Memuat rakitan ke dalam konteks khusus refleksi, dengan 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 Assembly objek sama.
Inequality(Assembly, Assembly)	Menunjukkan apakah dua Assembly objek 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 digunakan kembali, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetModules(Assembly)	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat digunakan kembali, dan menggambarkan sendiri blok penyusun aplikasi runtime bahasa umum.
GetTypes(Assembly)	Mewakili rakitan, yang merupakan blok penyusun yang dapat digunakan kembali, dapat digunakan kembali, 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 assembly, untuk digunakan dengan MetadataReader.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• AppDomain
• AssemblyName
• Domain Aplikasi