使用 dynamic 類型 (C# 程式設計手冊)

C# 4 引進一種新型別 dynamic。 此類型是靜態類型,但 dynamic 類型的物件會略過靜態類型檢查。 在大多數情況下,其運作會像是具有 object 類型。 在編譯時期,會假設類型為 dynamic 的項目能夠支援所有作業。 因此,您無須考慮物件是從 COM API、動態語言 (例如 IronPython)、HTML 文件物件模型 (DOM)、反映或是程式其他地方取得其值。 不過,如果程式碼無效,則會在執行階段攔截到錯誤。

例如,如果下列程式碼中的執行個體方法 exampleMethod1 只有一個參數,則編譯器會將 ec.exampleMethod1(10, 4) 方法的第一個呼叫視為無效,因為它包含兩個引數。 呼叫會造成編譯器錯誤。 編譯器不會檢查 dynamic_ec.exampleMethod1(10, 4) 方法的第二個呼叫,因為 dynamic_ec 的類型為 dynamic。 因此,不會報告編譯器錯誤。 不過,這項錯誤並不是永遠不會被發現。 它會在執行階段被攔截,並造成執行階段例外狀況。

static void Main(string[] args)
{
    ExampleClass ec = new ExampleClass();
    // The following call to exampleMethod1 causes a compiler error
    // if exampleMethod1 has only one parameter. Uncomment the line
    // to see the error.
    //ec.exampleMethod1(10, 4);

    dynamic dynamic_ec = new ExampleClass();
    // The following line is not identified as an error by the
    // compiler, but it causes a run-time exception.
    dynamic_ec.exampleMethod1(10, 4);

    // The following calls also do not cause compiler errors, whether
    // appropriate methods exist or not.
    dynamic_ec.someMethod("some argument", 7, null);
    dynamic_ec.nonexistentMethod();
}
class ExampleClass
{
    public ExampleClass() { }
    public ExampleClass(int v) { }

    public void exampleMethod1(int i) { }

    public void exampleMethod2(string str) { }
}

上述範例中的編譯器角色,就是將每個陳述式應該對類型為 dynamic 的物件或運算式所進行之動作的相關資訊封裝在一起。 在執行階段,會檢查這些預存資訊,如果有任何陳述式無效,便會造成執行階段例外狀況。

大多數動態作業的結果本身就是 dynamic。 例如,如果您在下列範例中將滑鼠指標停在 testSum 的使用用途上,IntelliSense 會顯示 testSum 類型。

dynamic d = 1;
var testSum = d + 3;
// Rest the mouse pointer over testSum in the following statement.
System.Console.WriteLine(testSum);

結果不是 dynamic 的作業包括:

  • dynamic 轉換成另一種類型。
  • 包含 dynamic 類型引數的建構函式呼叫。

例如,下列宣告中 testInstance 的類型是 ExampleClass,而不是 dynamic

var testInstance = new ExampleClass(d);

下一節<轉換>會顯示轉換範例。

轉換

動態物件和其他類型間的轉換很簡單。 因此,開發人員可以在動態和非動態行為之間進行切換。

所有物件都能隱含轉換成動態類型,如下列範例所示。

dynamic d1 = 7;
dynamic d2 = "a string";
dynamic d3 = System.DateTime.Today;
dynamic d4 = System.Diagnostics.Process.GetProcesses();

相反地,隱含轉換可以動態套用至 dynamic 類型的任何運算式。

int i = d1;
string str = d2;
DateTime dt = d3;
System.Diagnostics.Process[] procs = d4;

dynamic 類型引數的多載解析

如果方法呼叫中有一或多個引數的類型為 dynamic,或如果方法呼叫的接收端類型為 dynamic,則會在執行階段 (而不是編譯時期) 發生多載解析。 在下列範例中,如果唯一可存取的 exampleMethod2 方法已定義為接受字串引數,則將 d1 作為引數傳送不會造成編譯器錯誤,但會造成執行階段例外狀況。 多載解析會在執行階段失敗,因為 d1 的執行階段類型為 int,而 exampleMethod2 需要字串。

// Valid.
ec.exampleMethod2("a string");

// The following statement does not cause a compiler error, even though ec is not
// dynamic. A run-time exception is raised because the run-time type of d1 is int.
ec.exampleMethod2(d1);
// The following statement does cause a compiler error.
//ec.exampleMethod2(7);

Dynamic Language Runtime

動態語言執行時間 (DLR) 是 .NET Framework 4 中引進的 API。 它提供的基礎結構支援 C# 中的 dynamic 類型,也支援實作 IronPython 和 IronRuby 之類的動態程式設計語言。 如需 DLR 的詳細資訊,請參閱 Dynamic Language Runtime 概觀

COM Interop

C# 4 包含幾項功能,可改善與 COM API (例如 Office Automation API) 相互操作的體驗。 這些改進包括使用 dynamic 類型,以及使用dynamic

許多 COM 方法允許針對引數類型和傳回型別進行變化,方法是將類型指定為 object。 這需要對值進行明確轉型,才能與 C# 中的強型別變數配合使用。 如果您使用EmbedInteropTypes (c # 編譯器選項) 選項進行編譯,則此類型的引入 可讓您將出現 在 COM 簽章中的專案視為類型 dynamic ,並藉此避免大部分的轉換。 例如,下列陳述式將比較使用 dynamic 類型和不使用 dynamic 類型存取 Microsoft Office Excel 試算表中儲存格的方式。

// Before the introduction of dynamic.
((Excel.Range)excelApp.Cells[1, 1]).Value2 = "Name";
Excel.Range range2008 = (Excel.Range)excelApp.Cells[1, 1];
// After the introduction of dynamic, the access to the Value property and
// the conversion to Excel.Range are handled by the run-time COM binder.
excelApp.Cells[1, 1].Value = "Name";
Excel.Range range2010 = excelApp.Cells[1, 1];
標題 描述
動態 說明如何使用 dynamic 關鍵字。
動態語言執行時間總覽 提供 DLR 概觀,DLR 是在 Common Language Runtime (CLR) 中新增一組動態語言服務的執行階段環境。
逐步解說:建立和使用動態物件 針對建立自訂動態物件及建立存取 IronPython 程式庫的專案,提供逐步指示。
如何使用 C# 功能存取 Office Interop 物件 示範如何建立使用具名和選擇性引數、dynamic 類型,以及其他可簡化 Office API 物件存取之增強功能的專案。