Assembly.GetType 方法

參考

定義

命名空間:: System.Reflection

組件:: System.Reflection.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得代表指定類型的 Type 物件。

多載

GetType(String, Boolean, Boolean)	使用忽略大小寫和找不到類型時擲回例外狀況的選項，取得具有組件執行個體中指定之名稱的 Type 物件。
GetType(String, Boolean)	取得具有組件執行個體中指定之名稱的 Type 物件，並在找不到類型時選擇性地擲回例外狀況。
GetType(String)	取得具有組件執行個體中指定名稱的 Type 物件。
GetType()

GetType(String, Boolean, Boolean)

來源:: Assembly.cs

來源:: Assembly.cs

來源:: Assembly.cs

使用忽略大小寫和找不到類型時擲回例外狀況的選項，取得具有組件執行個體中指定之名稱的 Type 物件。

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

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

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

public 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

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

參數

name: String

類型的完整名稱。

throwOnError: Boolean

true 表示找不到該類型時擲回例外狀況，false 則表示傳回 null。

ignoreCase: Boolean

若要忽略類型名稱的大小寫，則為 true，否則為 false。

傳回

Type

表示指定之類別的物件。

實作

GetType(String, Boolean, Boolean)

例外狀況

ArgumentException

name 無效。

-或-

name 的長度超過 1024 個字元。

ArgumentNullException

name 為 null。

TypeLoadException

throwOnError 為 true，而且找不到類型。

FileNotFoundException

找不到 name 所需的相依組件。

FileLoadException

找到 name 所需的相依組件，但無法載入。

-或-

目前的組件已載入僅限反映的內容中，而且 name 需要未預先載入的相依組件。

BadImageFormatException

typeName 需要相依元件，但檔案不是目前載入運行時間的有效元件。

備註

這個方法只會搜尋目前的元件實例。參數 name 包含命名空間，但不包含元件。若要搜尋類型的其他元件，請使用 Type.GetType(String) 方法多載，其可以選擇性地包含元件顯示名稱做為類型名稱的一部分。

注意

如果類型已轉送到另一個元件，此方法仍會傳回它。如需類型轉送的資訊，請參閱 Common Language Runtime 中的類型轉送。

參數 throwOnError 只會影響找不到類型時會發生什麼情況。它不會影響任何其他可能擲回的例外狀況。特別是，如果找到型別但無法載入，TypeLoadException即使為 false，也可以擲回throwOnError。

適用於

GetType(String, Boolean)

來源:: Assembly.cs

來源:: Assembly.cs

來源:: Assembly.cs

取得具有組件執行個體中指定之名稱的 Type 物件，並在找不到類型時選擇性地擲回例外狀況。

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

public virtual Type? GetType (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

參數

name: String

類型的完整名稱。

throwOnError: Boolean

true 表示找不到該類型時擲回例外狀況，false 則表示傳回 null。

傳回

Type

表示指定之類別的物件。

實作

GetType(String, Boolean)

例外狀況

ArgumentException

name 無效。

-或-

name 的長度超過 1024 個字元。

ArgumentNullException

name 為 null。

TypeLoadException

throwOnError 為 true，而且找不到類型。

FileNotFoundException

找不到 name 所需的相依組件。

FileLoadException

找到 name 所需的相依組件，但無法載入。

-或-

目前的組件已載入僅限反映的內容中，而且 name 需要未預先載入的相依組件。

BadImageFormatException

typeName 需要相依元件，但檔案不是目前載入運行時間的有效元件。

備註

注意

如果類型已轉送到另一個元件，此方法仍會傳回它。如需類型轉送的資訊，請參閱 Common Language Runtime 中的類型轉送。

適用於

GetType(String)

來源:: Assembly.cs

來源:: Assembly.cs

來源:: Assembly.cs

取得具有組件執行個體中指定名稱的 Type 物件。

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

public virtual Type GetType (string name);

public virtual Type? GetType (string name);

override this.GetType : string -> Type

Public Overridable Function GetType (name As String) As Type

參數

name: String

類型的完整名稱。

傳回

Type

物件，表示指定的類別，如果找不到類別，則為 null。

實作

GetType(String)

例外狀況

ArgumentException

name 無效。

ArgumentNullException

name 為 null。

FileNotFoundException

找不到 name 所需的相依組件。

FileLoadException

找到 name 所需的相依組件，但無法載入。

-或-

目前的組件已載入僅限反映的內容中，而且 name 需要未預先載入的相依組件。

注意：在適用於 Windows 市集應用程式的 .NET 或可攜式類別庫中，改為攔截基類例外狀況 IOException。

BadImageFormatException

typeName 需要相依元件，但檔案不是目前載入運行時間的有效元件。

範例

下列範例會在命名空間中Transportation定義抽象MeansOfTransportation類。它會呼叫 GetType(String) 方法來擷取其 Type 物件、呼叫 Type.GetProperties 方法來取得代表類型屬性的物件陣列 PropertyInfo ，然後顯示類型抽象屬性的相關信息。請注意，對方法的呼叫 GetType(String) 會使用類型的完整名稱 (，也就是其命名空間及其類型名稱) 。

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)

備註

注意

如果類型已轉送到另一個元件，此方法仍會傳回它。如需類型轉送的資訊，請參閱 Common Language Runtime 中的類型轉送。

適用於

GetType()

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

傳回

Type

實作

GetType()

適用於

共用方式為

Assembly.GetType 方法

定義

多載

GetType(String, Boolean, Boolean)

參數

傳回

實作

例外狀況

備註

適用於

GetType(String, Boolean)

參數

傳回

實作

例外狀況

備註

適用於

GetType(String)

參數

傳回

實作

例外狀況

範例

備註

適用於

GetType()

傳回

實作

適用於

其他資源