Assembly.GetType Metode

Definisi

Ruang nama:

System.Reflection

Rakitan:

System.Runtime.dll

Type Mendapatkan objek yang mewakili jenis yang ditentukan.

Overload

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.
GetType(String, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan.
GetType(String)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly.

GetType(String, Boolean, Boolean)

Sumber:

Assembly.cs

Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly, dengan opsi mengabaikan kasus, dan melemparkan pengecualian jika jenisnya tidak ditemukan.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError, bool ignoreCase);

public virtual Type? GetType (string name, bool throwOnError, bool ignoreCase);

override this.GetType : string * bool * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parameter

name

String

Nama lengkap jenis.

throwOnError

Boolean

true untuk melemparkan pengecualian jika jenis tidak ditemukan; false untuk mengembalikan null.

ignoreCase

Boolean

true untuk mengabaikan kasus nama jenis; jika tidak, false.

Mengembalikan

Type

Objek yang mewakili kelas yang ditentukan.

Pengecualian

ArgumentException

name tidak valid.

-atau-

Panjang name melebihi 1024 karakter.

ArgumentNullException

nameadalah null.

TypeLoadException

throwOnError adalah true, dan jenis tidak dapat ditemukan.

FileNotFoundException

name memerlukan rakitan dependen yang tidak dapat ditemukan.

FileLoadException

name memerlukan rakitan dependen yang ditemukan tetapi tidak dapat dimuat.

-atau-

Rakitan saat ini dimuat ke dalam konteks khusus refleksi, dan name memerlukan rakitan dependen yang tidak dimuat sebelumnya.

BadImageFormatException

typeName memerlukan rakitan dependen, tetapi file bukan rakitan yang valid untuk runtime yang saat ini dimuat.

Keterangan

Metode ini hanya mencari instans rakitan saat ini. Parameter name mencakup namespace tetapi bukan assembly. Untuk mencari rakitan lain untuk jenis, gunakan Type.GetType(String) metode kelebihan beban, yang secara opsional dapat menyertakan nama tampilan rakitan sebagai bagian dari nama jenis.

Catatan

Jika jenis telah diteruskan ke rakitan lain, jenis tersebut masih dikembalikan oleh metode ini. Untuk informasi tentang penerusan jenis, lihat Penerusan Jenis di Common Language Runtime.

Parameter throwOnError hanya memengaruhi apa yang terjadi ketika jenis tidak ditemukan. Ini tidak mempengaruhi pengecualian lain yang mungkin dilemparkan. Secara khusus, jika jenis ditemukan tetapi tidak dapat dimuat, TypeLoadException dapat dilemparkan bahkan jika throwOnError adalah false.

GetType(String, Boolean)

Sumber:

Assembly.cs

Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError);

public virtual Type? GetType (string name, bool throwOnError);

override this.GetType : string * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean) As Type

Parameter

name

String

Nama lengkap jenis.

throwOnError

Boolean

true untuk melemparkan pengecualian jika jenis tidak ditemukan; false untuk mengembalikan null.

Mengembalikan

Type

Objek yang mewakili kelas yang ditentukan.

Pengecualian

ArgumentException

name tidak valid.

-atau-

Panjang name melebihi 1024 karakter.

ArgumentNullException

nameadalah null.

TypeLoadException

throwOnError adalah true, dan jenis tidak dapat ditemukan.

FileNotFoundException

name memerlukan rakitan dependen yang tidak dapat ditemukan.

FileLoadException

name memerlukan rakitan dependen yang ditemukan tetapi tidak dapat dimuat.

-atau-

Rakitan saat ini dimuat ke dalam konteks khusus refleksi, dan name memerlukan rakitan dependen yang tidak dimuat sebelumnya.

BadImageFormatException

typeName memerlukan rakitan dependen, tetapi file bukan rakitan yang valid untuk runtime yang saat ini dimuat.

Keterangan

Metode ini hanya mencari instans rakitan saat ini. Parameter name mencakup namespace tetapi bukan assembly. Untuk mencari rakitan lain untuk jenis, gunakan Type.GetType(String) metode kelebihan beban, yang secara opsional dapat menyertakan nama tampilan rakitan sebagai bagian dari nama jenis.

Catatan

Jika jenis telah diteruskan ke rakitan lain, jenis tersebut masih dikembalikan oleh metode ini. Untuk informasi tentang penerusan jenis, lihat Penerusan Jenis di Common Language Runtime.

Parameter throwOnError hanya memengaruhi apa yang terjadi ketika jenis tidak ditemukan. Ini tidak mempengaruhi pengecualian lain yang mungkin dilemparkan. Secara khusus, jika jenis ditemukan tetapi tidak dapat dimuat, TypeLoadException dapat dilemparkan bahkan jika throwOnError adalah false.

GetType(String)

Sumber:

Assembly.cs

Mendapatkan objek dengan nama yang ditentukan dalam instans Type assembly.

public:
 virtual Type ^ GetType(System::String ^ name);

public virtual Type? GetType (string name);

override this.GetType : string -> Type

Public Overridable Function GetType (name As String) As Type

Parameter

name

String

Nama lengkap jenis.

Mengembalikan

Type

Objek yang mewakili kelas yang ditentukan, atau null jika kelas tidak ditemukan.

Pengecualian

ArgumentException

name tidak valid.

ArgumentNullException

nameadalah null.

FileNotFoundException

name memerlukan rakitan dependen yang tidak dapat ditemukan.

FileLoadException

name memerlukan rakitan dependen yang ditemukan tetapi tidak dapat dimuat.

-atau-

Rakitan saat ini dimuat ke dalam konteks khusus refleksi, dan name memerlukan rakitan dependen yang tidak dimuat sebelumnya.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap pengecualian kelas dasar, IOException, sebagai gantinya.

BadImageFormatException

typeName memerlukan rakitan dependen, tetapi file bukan rakitan yang valid untuk runtime yang saat ini dimuat.

Contoh

Contoh berikut mendefinisikan kelas abstrak MeansOfTransportation di Transportation namespace layanan. Ini memanggil GetType(String) metode untuk mengambil objeknya Type , memanggil Type.GetProperties metode untuk mendapatkan array PropertyInfo objek yang mewakili properti jenis, lalu menampilkan informasi tentang properti abstrak jenis. Perhatikan bahwa panggilan ke GetType(String) metode menggunakan nama tipe yang sepenuhnya memenuhi syarat (yaitu, namespace layanannya bersama dengan nama jenisnya).

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;
        Type t = assem.GetType("Transportation.MeansOfTransportation");
        if (t != null)
        {
            Console.WriteLine($"Virtual properties in type {t.FullName}:");
            PropertyInfo[] props = t.GetProperties();
            int nVirtual = 0;
            for (int ctr = 0; ctr < props.Length; ctr++)
            {
                if (props[ctr].GetMethod.IsVirtual)
                {
                    Console.WriteLine($"   {props[ctr].Name} (type {props[ctr].PropertyType.FullName})");
                    nVirtual++;
                }
            }

            if (nVirtual == 0)
                Console.WriteLine("   No virtual properties");
        }
    }
}

namespace Transportation
{
    public abstract class MeansOfTransportation
    {
        abstract public bool HasWheels { get; set; }
        abstract public int Wheels { get; set; }
        abstract public bool ConsumesFuel { get; set; }
        abstract public bool Living { get; set; }
    }
}
// The example displays the following output:
//    Virtual properties in type Transportation.MeansOfTransportation:
//       HasWheels (type System.Boolean)
//       Wheels (type System.Int32)
//       ConsumesFuel (type System.Boolean)
//       Living (type System.Boolean)

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Example).Assembly
      Dim t As Type = assem.GetType("Transportation.MeansOfTransportation")
      If Not t Is Nothing Then
         Console.WriteLine("Virtual properties in type {0}:", 
                           t.FullName)
         Dim props() As PropertyInfo = t.GetProperties()
         Dim nVirtual As Integer = 0
         For ctr As Integer = 0 To props.Length - 1
            If props(ctr).GetMethod.IsVirtual Then
               Console.WriteLine("   {0} (type {1})",
                                 props(ctr).Name, 
                                 props(ctr).PropertyType.FullName)
               nVirtual += 1
            End If
         Next
         If nVirtual = 0 Then 
            Console.WriteLine("   No virtual properties")
         End If   
      End If   
   End Sub
End Module

Namespace Transportation
   Public MustInherit Class MeansOfTransportation
      Public MustOverride Property HasWheels As Boolean
      Public MustOverride Property Wheels As Integer
      Public MustOverride Property ConsumesFuel As Boolean
      Public MustOverride Property Living As Boolean
   End Class
End Namespace
' The example displays the following output:
'    Virtual properties in type Transportation.MeansOfTransportation:
'       HasWheels (type System.Boolean)
'       Wheels (type System.Int32)
'       ConsumesFuel (type System.Boolean)
'       Living (type System.Boolean)

Keterangan

Metode ini hanya mencari instans rakitan saat ini. Parameter name mencakup namespace tetapi bukan assembly. Untuk mencari rakitan lain untuk jenis, gunakan Type.GetType(String) metode kelebihan beban, yang secara opsional dapat menyertakan nama tampilan rakitan sebagai bagian dari nama jenis.

Catatan

Jika jenis telah diteruskan ke rakitan lain, jenis tersebut masih dikembalikan oleh metode ini. Untuk informasi tentang penerusan jenis, lihat Penerusan Jenis di Common Language Runtime.