指定完整類型名稱

您必須指定具有各種反映作業有效輸入的類型名稱。 完整的類型名稱包括組件名稱規格、命名空間規格和類型名稱。 方法使用的類型名稱規格如 Type.GetType、Module.GetType、ModuleBuilder.GetType 和 Assembly.GetType。

類型名稱的文法

文法會定義正式語言的語法。 下表列出語彙規則，說明如何辨識有效的輸入。 終端項 (不會進一步縮減的那些項目) 全部以大寫字母顯示。 非終端項 (會進一步縮減的那些項目) 會以大小寫混合或單引號括住的字串顯示，但單引號 (') 不是語法本身的一部分。 縱線字元 (|) 表示具有子規則的規則。

TypeSpec
	: ReferenceTypeSpec
	| SimpleTypeSpec
	;

ReferenceTypeSpec
	: SimpleTypeSpec '&'
	;

SimpleTypeSpec
	: PointerTypeSpec
	| GenericTypeSpec
	| TypeName
	;

GenericTypeSpec
   : SimpleTypeSpec ` NUMBER

PointerTypeSpec
	: SimpleTypeSpec '*'
	;

ArrayTypeSpec
	: SimpleTypeSpec '[ReflectionDimension]'
	| SimpleTypeSpec '[ReflectionEmitDimension]'
	;

ReflectionDimension
	: '*'
	| ReflectionDimension ',' ReflectionDimension
	| NOTOKEN
	;

ReflectionEmitDimension
	: '*'
	| Number '..' Number
	| Number '…'
	| ReflectionDimension ',' ReflectionDimension
	| NOTOKEN
	;

Number
	: [0-9]+
	;

TypeName
	: NamespaceTypeName
	| NamespaceTypeName ',' AssemblyNameSpec
	;

NamespaceTypeName
	: NestedTypeName
	| NamespaceSpec '.' NestedTypeName
	;

NestedTypeName
	: IDENTIFIER
	| NestedTypeName '+' IDENTIFIER
	;

NamespaceSpec
	: IDENTIFIER
	| NamespaceSpec '.' IDENTIFIER
	;

AssemblyNameSpec
	: IDENTIFIER
	| IDENTIFIER ',' AssemblyProperties
	;

AssemblyProperties
	: AssemblyProperty
	| AssemblyProperties ',' AssemblyProperty
	;

AssemblyProperty
	: AssemblyPropertyName '=' AssemblyPropertyValue
	;

指定特殊字元

類型名稱中的 IDENTIFIER 是語言規則判定的任何有效名稱。

將反斜線 (\) 用作逸出字元，分隔下列用作為 IDENTIFIER 一部分的權杖。

在 AssemblyNameSpec 以外的所有 TypeSpec 元件中，空格都相關。 在 AssemblyNameSpec 中，',' 分隔符號之前的空格是相關的，但 ',' 分隔符號之後的空格則會忽略。

Type.FullName 之類的反映類別會傳回損害的名稱，所以傳回的名稱可用於呼叫 GetType，如在 MyType.GetType(myType.FullName) 中一樣。

例如，類型的完整名稱可能是 Ozzy.OutBack.Kangaroo+Wallaby,MyAssembly。

如果以前的命名空間是 Ozzy.Out+Back，則反斜線前面必須有加號。 否則，剖析器會將它解譯為巢狀分隔符號。 反映將此字串發出為 Ozzy.Out\+Back.Kangaroo+Wallaby,MyAssembly。

指定組件名稱

組件名稱規格中的基本資訊是組件的文字名稱 (IDENTIFIER)。 您可以按照逗號分隔的屬性/值組清單理解 IDENTIFIER，如下表所述。 IDENTIFIER 的命名應依照檔案命名的規則。 IDENTIFIER 不區分大小寫。

下例示範的 AssemblyName，僅以預設文化特性命名組件。

com.microsoft.crypto, Culture=""

下例顯示具有 "en" 文化特性之強式名稱組件的完整指定參考。

com.microsoft.crypto, Culture=en, PublicKeyToken=a5d015c7d5a0b012,
    Version=1.0.0.0

下列範例各自都有部分指定的 AssemblyName，無論強式或簡單名稱組件皆可滿足。

com.microsoft.crypto
com.microsoft.crypto, Culture=""
com.microsoft.crypto, Culture=en

下列範例各自都有部分指定的 AssemblyName，必須由簡單名稱組件滿足。

com.microsoft.crypto, Culture="", PublicKeyToken=null
com.microsoft.crypto, Culture=en, PublicKeyToken=null

下列範例各自都有部分指定的 AssemblyName，必須由強式名稱組件滿足。

com.microsoft.crypto, Culture="", PublicKeyToken=a5d015c7d5a0b012
com.microsoft.crypto, Culture=en, PublicKeyToken=a5d015c7d5a0b012,
    Version=1.0.0.0

指定泛型型別

SimpleTypeSpec`NUMBER 代表含有 1 到 n 泛型型別參數的開放式泛型型別。 例如，若要取得開啟泛型型別或封閉式泛型型List<T>List<String>別的參考，請使用 Type.GetType("System.Collections.Generic.List`1") 取得泛型型別Dictionary<TKey,TValue>的參考，請使用 Type.GetType("System.Collections.Generic.Dictionary`2")。

指定指標

SimpleTypeSpec* 表示 Unmanaged 指標。 例如，若要取得類型 MyType 的指標，請使用 Type.GetType("MyType*")。 若要取得類型 MyType 指標的指標，請使用 Type.GetType("MyType**")。

指定參考

SimpleTypeSpec & 代表 Managed 指標或參考。 例如，若要取得類型 MyType 的參考，請使用 Type.GetType("MyType &")。 不同於指標，參考限製為一個層級。

指定陣列

在 BNF 文法中，ReflectionEmitDimension 只適用於使用 ModuleBuilder.GetType 擷取的不完整類型定義。 不完整的類型定義是使用 System.Reflection.Emit 建構卻未呼叫 TypeBuilder.CreateType 的 TypeBuilder 物件。 ReflectionDimension 可以用來擷取任何已完成的類型定義，也就是已載入的類型。

指定陣列陣序即可存取反映中的陣列：

• Type.GetType("MyArray[]") 會取得下限為 0 的一維陣列。
• Type.GetType("MyArray[*]") 會取得下限不明的一維陣列。
• Type.GetType("MyArray[][]") 會取得二維陣列的陣列。
• Type.GetType("MyArray[*,*]") 和 Type.GetType("MyArray[,]") 會取得下限不明的矩形二維陣列。

從運行時間的觀點來看， MyArray[] != MyArray[*]但對於多維度陣列，這兩個表示法是相等的。 亦即 Type.GetType("MyArray [,]") == Type.GetType("MyArray[*,*]") 評估為 true。

針對 ModuleBuilder.GetType， MyArray[0..5] 表示大小為 6、下限 0 的單一維度陣列。 MyArray[4…] 表示大小不明、下限 4 的一維陣列。

另請參閱

• AssemblyName
• ModuleBuilder
• TypeBuilder
• Type.FullName
• Type.GetType
• Type.AssemblyQualifiedName
• 檢視類型資訊