DynamicObject クラス

リファレンス

定義

名前空間:: System.Dynamic

アセンブリ:: System.Dynamic.Runtime.dll

アセンブリ:: System.Linq.Expressions.dll

アセンブリ:: System.Core.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

実行時の動的な動作を指定する基底クラスを提供します。このクラスは継承される必要があります。直接インスタンス化することはできません。

public ref class DynamicObject : System::Dynamic::IDynamicMetaObjectProvider

public class DynamicObject : System.Dynamic.IDynamicMetaObjectProvider

[System.Serializable]
public class DynamicObject : System.Dynamic.IDynamicMetaObjectProvider

type DynamicObject = class
    interface IDynamicMetaObjectProvider

[<System.Serializable>]
type DynamicObject = class
    interface IDynamicMetaObjectProvider

Public Class DynamicObject
Implements IDynamicMetaObjectProvider

継承: Object
DynamicObject

派生: System.Windows.Interop.DynamicScriptObject

属性: SerializableAttribute

実装: IDynamicMetaObjectProvider

例

辞書内の値にアクセスするための代替構文を指定して、(Visual Basicで)sampleDictionary("Text") = "Sample text" 書くsampleDictionary["Text"] = "Sample text"代わりに記述sampleDictionary.Text = "Sample text"できるようにするとします。また、この構文では大文字と小文字を区別しないようにする必要があるためsampleDictionary.Text``sampleDictionary.text、これは .

次のコード例は、クラスから派生したクラスをDynamicObject示していますDynamicDictionary。このDynamicDictionaryクラスには、キーと値のペアを格納する型 (Dictionary<string, object>``Dictionary(Of String, Object)Visual Basic) のオブジェクトが含まれており、新しい構文をTrySetMemberサポートするメソッドとTryGetMemberメソッドがオーバーライドされます。また、ディクショナリに Count 含まれる動的プロパティの数を示すプロパティも提供します。

// The class derived from DynamicObject.
public class DynamicDictionary : DynamicObject
{
    // The inner dictionary.
    Dictionary<string, object> dictionary
        = new Dictionary<string, object>();

    // This property returns the number of elements
    // in the inner dictionary.
    public int Count
    {
        get
        {
            return dictionary.Count;
        }
    }

    // If you try to get a value of a property
    // not defined in the class, this method is called.
    public override bool TryGetMember(
        GetMemberBinder binder, out object result)
    {
        // Converting the property name to lowercase
        // so that property names become case-insensitive.
        string name = binder.Name.ToLower();

        // If the property name is found in a dictionary,
        // set the result parameter to the property value and return true.
        // Otherwise, return false.
        return dictionary.TryGetValue(name, out result);
    }

    // If you try to set a value of a property that is
    // not defined in the class, this method is called.
    public override bool TrySetMember(
        SetMemberBinder binder, object value)
    {
        // Converting the property name to lowercase
        // so that property names become case-insensitive.
        dictionary[binder.Name.ToLower()] = value;

        // You can always add a value to a dictionary,
        // so this method always returns true.
        return true;
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Creating a dynamic dictionary.
        dynamic person = new DynamicDictionary();

        // Adding new dynamic properties.
        // The TrySetMember method is called.
        person.FirstName = "Ellen";
        person.LastName = "Adams";

        // Getting values of the dynamic properties.
        // The TryGetMember method is called.
        // Note that property names are case-insensitive.
        Console.WriteLine(person.firstname + " " + person.lastname);

        // Getting the value of the Count property.
        // The TryGetMember is not called,
        // because the property is defined in the class.
        Console.WriteLine(
            "Number of dynamic properties:" + person.Count);

        // The following statement throws an exception at run time.
        // There is no "address" property,
        // so the TryGetMember method returns false and this causes a
        // RuntimeBinderException.
        // Console.WriteLine(person.address);
    }
}

// This example has the following output:
// Ellen Adams
// Number of dynamic properties: 2

' The class derived from DynamicObject.
Public Class DynamicDictionary
    Inherits DynamicObject

    ' The inner dictionary.
    Dim dictionary As New Dictionary(Of String, Object)

    ' This property returns the number of elements
    ' in the inner dictionary.
    ReadOnly Property Count As Integer
        Get
            Return dictionary.Count
        End Get
    End Property


    ' If you try to get a value of a property that is
    ' not defined in the class, this method is called.

    Public Overrides Function TryGetMember(
        ByVal binder As System.Dynamic.GetMemberBinder,
        ByRef result As Object) As Boolean

        ' Converting the property name to lowercase
        ' so that property names become case-insensitive.
        Dim name As String = binder.Name.ToLower()

        ' If the property name is found in a dictionary,
        ' set the result parameter to the property value and return true.
        ' Otherwise, return false.
        Return dictionary.TryGetValue(name, result)
    End Function

    Public Overrides Function TrySetMember(
        ByVal binder As System.Dynamic.SetMemberBinder,
        ByVal value As Object) As Boolean

        ' Converting the property name to lowercase
        ' so that property names become case-insensitive.
        dictionary(binder.Name.ToLower()) = value

        ' You can always add a value to a dictionary,
        ' so this method always returns true.
        Return True
    End Function
End Class

Sub Main()
    ' Creating a dynamic dictionary.
    Dim person As Object = New DynamicDictionary()

    ' Adding new dynamic properties.
    ' The TrySetMember method is called.
    person.FirstName = "Ellen"
    person.LastName = "Adams"

    ' Getting values of the dynamic properties.
    ' The TryGetMember method is called.
    ' Note that property names are now case-insensitive,
    ' although they are case-sensitive in C#.
    Console.WriteLine(person.firstname & " " & person.lastname)

    ' Getting the value of the Count property.
    ' The TryGetMember is not called, 
    ' because the property is defined in the class.
    Console.WriteLine("Number of dynamic properties:" & person.Count)

    ' The following statement throws an exception at run time.
    ' There is no "address" property,
    ' so the TryGetMember method returns false and this causes
    ' a MissingMemberException.
    ' Console.WriteLine(person.address)
End Sub
' This examples has the following output:
' Ellen Adams
' Number of dynamic properties: 2

その他の例については、C# に関するよく寄せられる質問ブログの DynamicObject を使用したラッパーの作成を参照してください。

注釈

この DynamicObject クラスを使用すると、動的オブジェクトに対して実行できる操作とその操作の実行方法を定義できます。たとえば、オブジェクトプロパティの取得または設定、メソッドの呼び出し、加算や乗算などの標準的な数学演算の実行を試みた場合の動作を定義できます。

このクラスは、ライブラリのより便利なプロトコルを作成する場合に便利です。たとえば、ライブラリのユーザーが次のような構文を使用する必要がある場合は、次のようにScriptobj.SetProperty("Count", 1)``scriptobj.Count = 1、はるかに単純な構文を使用する機能を提供できます。

クラスの DynamicObject インスタンスを直接作成することはできません。動的な動作を実装するには、クラスから DynamicObject 継承し、必要なメソッドをオーバーライドすることができます。たとえば、プロパティの設定と取得に操作のみが必要な場合は、メソッドとTryGetMemberメソッドのみをTrySetMemberオーバーライドできます。

C# では、クラスから派生したクラスのインスタンスに対して動的な動作を DynamicObject 有効にするには、キーワードを dynamic 使用する必要があります。詳細については、「dynamic 型の使用」を参照してください。

Visual Basicでは、動的操作は遅延バインディングによってサポートされます。詳細については、「早期バインディングと遅延バインディング (Visual Basic)」を参照してください。

次のコード例は、クラスから派生したクラスのインスタンスを作成する方法を DynamicObject 示しています。

public class SampleDynamicObject : DynamicObject {}  
//...  
dynamic sampleObject = new SampleDynamicObject ();

Public Class SampleDynamicObject   
    Inherits DynamicObject  
'...  
Dim sampleObject As Object = New SampleDynamicObject()

クラスから派生したクラスに独自のメンバーを DynamicObject 追加することもできます。クラスがプロパティを定義し、メソッドをオーバーライド TrySetMember する場合、動的言語ランタイム (DLR) はまず言語バインダーを使用して、クラス内のプロパティの静的定義を検索します。このようなプロパティがない場合、DLR はメソッドを TrySetMember 呼び出します。

クラスは DynamicObject DLR インターフェイス IDynamicMetaObjectProviderを実装します。これにより、DLR 相互運用性モデルを DynamicObject サポートする言語間でクラスのインスタンスを共有できます。たとえば、C# でクラスのインスタンスを DynamicObject 作成し、IronPython 関数に渡すことができます。詳細については、「動的言語ランタイムの概要」を参照してください。

注意

実行時にのみメンバーを追加および削除できるが、特定の操作を定義する必要はなく、静的メンバーを持たないオブジェクトが必要な単純なシナリオがある場合は、クラスを ExpandoObject 使用します。

動的オブジェクトが相互運用性プロトコルにどのように参加するかを定義する必要があるより高度なシナリオがある場合、または DLR 高速動的ディスパッチキャッシュを管理する必要がある場合は、インターフェイスの独自の実装を IDynamicMetaObjectProvider 作成します。

コンストラクター

DynamicObject()

派生型で DynamicObject 型の新しいインスタンスを初期化できるようにします。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetDynamicMemberNames()	すべての動的メンバー名の列挙値を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetMetaObject(Expression)	動的仮想メソッドにディスパッチされる DynamicMetaObject を提供します。このオブジェクトを別の DynamicMetaObject の内部にカプセル化することにより、個々のアクションのカスタム動作を指定することができます。このメソッドは言語実装者向けの DLR (動的言語ランタイム) インフラストラクチャをサポートします。コードから直接使用するためのものではありません。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TryBinaryOperation(BinaryOperationBinder, Object, Object)	二項演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、加算や乗算などの演算の動的な動作を指定できます。
TryConvert(ConvertBinder, Object)	型変換演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、オブジェクトの型を別の型に変換する演算の動的な動作を指定できます。
TryCreateInstance(CreateInstanceBinder, Object[], Object)	動的オブジェクトの新しいインスタンスを初期化する演算の実装を提供します。このメソッドは、C# または Visual Basic で使用するためのものではありません。
TryDeleteIndex(DeleteIndexBinder, Object[])	インデックスを使用してオブジェクトを削除する演算の実装を提供します。このメソッドは、C# または Visual Basic で使用するためのものではありません。
TryDeleteMember(DeleteMemberBinder)	オブジェクトメンバーを削除する演算の実装を提供します。このメソッドは、C# または Visual Basic で使用するためのものではありません。
TryGetIndex(GetIndexBinder, Object[], Object)	インデックスを使用して値を取得する演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、インデックス演算の動的な動作を指定できます。
TryGetMember(GetMemberBinder, Object)	メンバー値を取得する演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、プロパティ値の取得などの演算の動的な動作を指定できます。
TryInvoke(InvokeBinder, Object[], Object)	オブジェクトを呼び出す演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、オブジェクトやデリゲートの呼び出しなどの演算の動的な動作を指定できます。
TryInvokeMember(InvokeMemberBinder, Object[], Object)	メンバーを呼び出す演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、メソッドの呼び出しなどの演算の動的な動作を指定できます。
TrySetIndex(SetIndexBinder, Object[], Object)	インデックスを使用して値を設定する演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、指定したインデックスを使用してオブジェクトにアクセスする演算の動的な動作を指定できます。
TrySetMember(SetMemberBinder, Object)	メンバー値を設定する演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、プロパティ値の設定などの演算の動的な動作を指定できます。
TryUnaryOperation(UnaryOperationBinder, Object)	単項演算の実装を提供します。 DynamicObject クラスの派生クラスでこのメソッドをオーバーライドして、否定、インクリメント、デクリメントなどの演算の動的な動作を指定できます。

適用対象

DynamicObject クラス

定義

例

注釈

コンストラクター

メソッド

適用対象

その他のリソース