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

發行項
06/23/2022

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 物件存取之增強功能的專案。

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

轉換

dynamic 類型引數的多載解析

Dynamic Language Runtime

COM Interop

相關主題