dynamic (C# 參考)

發行項
08/12/2011

dynamic 型別可讓它發生所在的作業略過編譯時期型別檢查。這些作業會改在執行階段解析。 dynamic 型別可簡化對 COM API (例如 Office 自動化 API)、動態 API (例如 IronPython 程式庫) 及 HTML 文件物件模型 (DOM) 的存取。

在大多數情況下，型別 dynamic 的行為就像 object 型別一樣。不過，包含 dynamic 型別之運算式的作業沒有解析，或是由編譯器進行型別檢查。編譯器將作業的相關資訊封裝在一起，而且可在之後使用該資訊來評估執行階段的作業。做為程序的一部分，dynamic 型別的變數都會編譯為 object 型別的變數。因此，類型 dynamic 只存在於編譯時間，而不存在於執行階段。

下列範例會對比類型為 dynamic 的變數與類型為 object 的變數。若要在編譯時期確認每個變數的型別，將滑鼠指標停在 WriteLine 陳述式中的 dyn 或 obj 上方。 IntelliSense 會針對 dyn 顯示 [動態]，並針對 obj 顯示[物件]。

class Program
{
    static void Main(string[] args)
    {
        dynamic dyn = 1;
        object obj = 1;

        // Rest the mouse pointer over dyn and obj to see their
        // types at compile time.
        System.Console.WriteLine(dyn.GetType());
        System.Console.WriteLine(obj.GetType());
    }
}

WriteLine 陳述式會顯示 dyn 和 obj 的執行階段型別。在此時，兩者都具有相同的型別，也就是整數。產生以下輸出：

System.Int32

若要查看 dyn 和 obj 在編譯時期的差異，請在前一個範例的宣告和 WriteLine 陳述式之間加入下列兩行。

dyn = dyn + 3;
obj = obj + 3;

對於嘗試加入的整數和運算式 obj + 3 中的物件，會有編譯器錯誤的報告。然而，沒有 dyn + 3 的錯誤報告。由於 dyn 的類型是 dynamic，因此編譯時期不會檢查包含 dyn 的運算式。

內容

dynamic 關鍵字可以直接出現，或是做為建構之型別的元件，在下列狀況出現：

在宣告中，做為屬性、欄位、索引子、參數、傳回值、本機變數或型別條件約束的型別。下列類別定義在數個不同的宣告中使用 dynamic。

class ExampleClass
{
    // A dynamic field.
    static dynamic field;

    // A dynamic property.
    dynamic prop { get; set; }

    // A dynamic return type and a dynamic paramater type.
    public dynamic exampleMethod(dynamic d)
    {
        // A dynamic local variable.
        dynamic local = "Local variable";
        int two = 2;

        if (d is int)
        {
            return local;
        }
        else
        {
            return two;
        }
    }
}

在明確的型別轉換中，做為轉換的目標型別

static void convertToDynamic()
{
    dynamic d;
    int i = 20;
    d = (dynamic)i;
    Console.WriteLine(d);

    string s = "Example string.";
    d = (dynamic)s;
    Console.WriteLine(d);

    DateTime dt = DateTime.Today;
    d = (dynamic)dt;
    Console.WriteLine(d);

}
// Results:
// 20
// Example string.
// 2/17/2009 9:12:00 AM

在將型別當做值的任何內容中，例如在 is 運算子的右邊，或是 as 運算子，或是做為 typeof 的引數以當做建構之型別的一部分。例如，dynamic 可在下列運算式中使用。

int i = 8;
dynamic d;
// With the is operator.
// The dynamic type behaves like object. The following
// expression returns true unless someVar has the value null.
if (someVar is dynamic) { }

// With the as operator.
d = i as dynamic;

// With typeof, as part of a constructed type.
Console.WriteLine(typeof(List<dynamic>));

// The following statement causes a compiler error.
//Console.WriteLine(typeof(dynamic));

範例

下列範例會在數個宣告中使用 dynamic。 Main 方法也會以執行階段型別檢查來對比編譯時期型別檢查。

using System;

namespace DynamicExamples
{
    class Program
    {
        static void Main(string[] args)
        {
            ExampleClass ec = new ExampleClass();
            Console.WriteLine(ec.exampleMethod(10));
            Console.WriteLine(ec.exampleMethod("value"));

            // The following line causes a compiler error because exampleMethod
            // takes only one argument.
            //Console.WriteLine(ec.exampleMethod(10, 4));

            dynamic dynamic_ec = new ExampleClass();
            Console.WriteLine(dynamic_ec.exampleMethod(10));

            // Because dynamic_ec is dynamic, the following call to exampleMethod
            // with two arguments does not produce an error at compile time.
            // However, itdoes cause a run-time error. 
            //Console.WriteLine(dynamic_ec.exampleMethod(10, 4));
        }
    }

    class ExampleClass
    {
        static dynamic field;
        dynamic prop { get; set; }

        public dynamic exampleMethod(dynamic d)
        {
            dynamic local = "Local variable";
            int two = 2;

            if (d is int)
            {
                return local;
            }
            else
            {
                return two;
            }
        }
    }
}
// Results:
// Local variable
// 2
// Local variable

如需詳細資訊與範例，請參閱使用動態型別 (C# 程式設計手冊)。

請參閱

dynamic (C# 參考)

內容

範例

請參閱

工作

參考

其他資源

其他資源