Assembly Kelas

Definisi

Ruang nama:

System.Reflection

Rakitan:

netstandard.dll, 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 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 perakitan. Contoh menampilkan nomor versi rakitan, CodeBase properti, dan EntryPoint properti .

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 jenis tersebut.

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

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 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 perakitan harus diidentifikasi berdasarkan jalur.

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

Banyak anggota Assembly kelas memberikan informasi tentang perakitan. Misalnya:

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

• Metode ini GetCustomAttributes mencantumkan atribut yang diterapkan ke rakitan.

• 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 rakitan. Metode GetType ini dapat digunakan untuk mencari jenis tertentu dalam rakitan. Metode CreateInstance ini dapat digunakan untuk mencari dan membuat instans jenis dalam rakitan.

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

Konstruktor

Nama	Deskripsi
Assembly()	Menginisialisasi instans baru dari kelas Assembly.

Properti

Nama	Deskripsi
CodeBase	Kedaluwarsa. Mendapatkan lokasi rakitan seperti yang ditentukan awalnya, misalnya, dalam AssemblyName objek.
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 dipegang dalam koleksi 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 rakitan 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 kumpulan aturan keamanan mana yang diterapkan runtime bahasa umum (CLR) untuk rakitan ini.

Metode

Nama	Deskripsi
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.
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)	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, menggunakan pencarian peka huruf besar/kecil.
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 saat ini Assembly, yang dinyatakan sebagai CustomAttributeData objek.
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)	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 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()	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, Version)	Mendapatkan versi rakitan satelit yang ditentukan untuk budaya yang ditentukan.
GetSatelliteAssembly(CultureInfo)	Mendapatkan rakitan satelit untuk budaya yang ditentukan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetType(String, Boolean, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type rakitan, dengan opsi mengabaikan kasus, dan melemparkan pengecualian jika jenis tidak ditemukan.
GetType(String, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type rakitan dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan.
GetType(String)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type rakitan.
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 assembly yang diberikan AssemblyName.
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(Byte[])	Memuat rakitan dengan gambar berbasis format file objek umum (COFF) yang berisi rakitan yang dipancarkan.
Load(String)	Memuat rakitan dengan nama yang ditentukan.
LoadFile(String)	Memuat konten file rakitan pada jalur yang ditentukan.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Kedaluwarsa. Memuat rakitan yang diberikan nama file atau jalurnya, nilai hash, dan algoritma hash.
LoadFrom(String)	Memuat rakitan yang diberikan nama atau jalur filenya.
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.
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.
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.
SetEntryAssembly(Assembly)	Mengatur rakitan entri aplikasi ke objek perakitan yang disediakan.
ToString()	Mengembalikan nama lengkap rakitan, juga dikenal sebagai nama tampilan.
UnsafeLoadFrom(String)	Memuat rakitan ke dalam konteks load-from, melewati beberapa pemeriksaan keamanan.

Operator

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

Acara

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

Metode Ekstensi

Nama	Deskripsi
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, Type)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttributes(Assembly)	Mengambil kumpulan atribut kustom yang diterapkan ke rakitan tertentu.
GetCustomAttributes<T>(Assembly)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
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.
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