Module.GetType 方法

定義

命名空間:

System.Reflection

組件:

System.Runtime.dll

傳回指定的型別。

多載

GetType(String)	執行區分大小寫的搜尋，傳回指定的類型。
GetType(String, Boolean)	傳回指定的類型，使用指定的大小寫搜尋模組。
GetType(String, Boolean, Boolean)	傳回指定的型別，並指定是否要對模組進行區分大小寫的搜尋，以及是否要在找不到型別時擲回例外狀況。

GetType(String)

來源:

Module.cs

執行區分大小寫的搜尋，傳回指定的類型。

C#

public virtual Type? GetType (string className);

參數

className

String

要尋找的類型名稱。 名稱必須是命名空間的完整名稱。

傳回

Type

Type 物件，如果指定的類型位於此模組中，則代表該類型；否則為 null。

例外狀況

ArgumentNullException

className 為 null。

TargetInvocationException

叫用了類別初始設定式，並擲回例外狀況。

ArgumentException

className 是零長度字串

FileNotFoundException

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

FileLoadException

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

-或-

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

BadImageFormatException

className 需要相依組件，但這個檔案不是有效的組件。

-或-

className 所需的相依組件是針對比目前載入之版本還新的執行階段版本所編譯。

範例

下列範例會顯示指定模組中類型的名稱。

C#

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass");
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

備註

備註

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

您可以使用 從特定模組 Module.GetType擷取型別。 在包含指令清單的模組上呼叫 Module.GetType ，將不會搜尋整個元件。 若要從元件擷取類型，不論其位於哪一個模組，您都必須呼叫 Assembly.GetType。

GetType(String, Boolean)

來源:

Module.cs

傳回指定的類型，使用指定的大小寫搜尋模組。

C#

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

參數

className

String

要尋找的類型名稱。 名稱必須是命名空間的完整名稱。

ignoreCase

Boolean

true 以進行不區分大小寫的搜尋；否則為 false。

傳回

Type

Type 物件，如果指定的類型位於此模組中，則代表該類型；否則為 null。

例外狀況

ArgumentNullException

className 為 null。

TargetInvocationException

叫用了類別初始設定式，並擲回例外狀況。

ArgumentException

className 是零長度字串

FileNotFoundException

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

FileLoadException

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

-或-

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

BadImageFormatException

className 需要相依組件，但這個檔案不是有效的組件。

-或-

className 所需的相依組件是針對比目前載入之版本還新的執行階段版本所編譯。

範例

下列範例會顯示指定模組中型別的名稱， false 並指定 參數 ignoreCase ，因此不會忽略大小寫。

C#

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

備註

備註

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

您可以使用 從特定模組 Module.GetType擷取型別。 在包含指令清單的模組上呼叫 Module.GetType ，將不會搜尋整個元件。 若要從元件擷取類型，不論其位於哪一個模組，您都必須呼叫 Assembly.GetType。

GetType(String, Boolean, Boolean)

來源:

Module.cs

傳回指定的型別，並指定是否要對模組進行區分大小寫的搜尋，以及是否要在找不到型別時擲回例外狀況。

C#

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

參數

className

String

要尋找的類型名稱。 名稱必須是命名空間的完整名稱。

throwOnError

Boolean

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

ignoreCase

Boolean

true 以進行不區分大小寫的搜尋；否則為 false。

傳回

Type

如果在這個模組中宣告型別，則為表示指定之型別的 Type 物件，否則為 null。

例外狀況

ArgumentNullException

className 為 null。

TargetInvocationException

叫用了類別初始設定式，並擲回例外狀況。

ArgumentException

className 是零長度字串

TypeLoadException

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

FileNotFoundException

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

FileLoadException

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

-或-

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

BadImageFormatException

className 需要相依組件，但這個檔案不是有效的組件。

-或-

className 所需的相依組件是針對比目前載入之版本還新的執行階段版本所編譯。

範例

下列範例會顯示指定模組中類型的名稱。 throwOnError與 ignoreCase 參數會指定為 false。

C#

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing this class.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false, false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

備註

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

備註

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

您可以使用 從特定模組 Module.GetType擷取型別。 在包含指令清單的模組上呼叫 Module.GetType ，將不會搜尋整個元件。 若要從元件擷取類型，不論其位於哪一個模組，您都必須呼叫 Assembly.GetType。