DynamicObject Kelas

Definisi

Ruang nama:

System.Dynamic

Rakitan:

System.Linq.Expressions.dll

Sumber:

DynamicObject.cs

Menyediakan kelas dasar untuk menentukan perilaku dinamis pada durasi. Kelas ini harus diwarisi dari; Anda tidak dapat menginstansiasinya secara langsung.

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

public class DynamicObject : System.Dynamic.IDynamicMetaObjectProvider

type DynamicObject = class
    interface IDynamicMetaObjectProvider

Public Class DynamicObject
Implements IDynamicMetaObjectProvider

Warisan

Object

DynamicObject

Turunan

System.Windows.Interop.DynamicScriptObject

Penerapan

IDynamicMetaObjectProvider

Contoh

Asumsikan bahwa Anda ingin memberikan sintaks alternatif untuk mengakses nilai dalam kamus, sehingga alih-alih menulis sampleDictionary["Text"] = "Sample text" (sampleDictionary("Text") = "Sample text" di Visual Basic), Anda dapat menulis sampleDictionary.Text = "Sample text". Selain itu, Anda ingin sintaks ini tidak peka huruf besar/kecil, sehingga sampleDictionary.Text setara dengan sampleDictionary.text.

Contoh kode berikut menunjukkan DynamicDictionary kelas , yang berasal dari DynamicObject kelas . Kelas DynamicDictionary berisi objek jenis Dictionary<string, object> (Dictionary(Of String, Object) dalam Visual Basic) untuk menyimpan pasangan kunci-nilai, dan mengambil TrySetMember alih metode dan TryGetMember untuk mendukung sintaks baru. Ini juga menyediakan Count properti , yang menunjukkan berapa banyak properti dinamis yang dikandung kamus.

// 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

Untuk contoh selengkapnya, lihat Membuat Pembungkus dengan DynamicObject di blog Tanya Jawab Umum C#.

Keterangan

Kelas ini DynamicObject memungkinkan Anda menentukan operasi mana yang dapat dilakukan pada objek dinamis dan cara melakukan operasi tersebut. Misalnya, Anda dapat menentukan apa yang terjadi ketika Anda mencoba mendapatkan atau mengatur properti objek, memanggil metode, atau melakukan operasi matematika standar seperti penambahan dan perkalian.

Kelas ini dapat berguna jika Anda ingin membuat protokol yang lebih nyaman untuk pustaka. Misalnya, jika pengguna pustaka Anda harus menggunakan sintaks seperti Scriptobj.SetProperty("Count", 1), Anda dapat menyediakan kemampuan untuk menggunakan sintaks yang jauh lebih sederhana, seperti scriptobj.Count = 1.

Anda tidak dapat langsung membuat instans DynamicObject kelas. Untuk menerapkan perilaku dinamis, Anda mungkin ingin mewarisi dari DynamicObject kelas dan mengambil alih metode yang diperlukan. Misalnya, jika Anda hanya memerlukan operasi untuk mengatur dan mendapatkan properti, Anda hanya TrySetMember dapat mengambil alih metode dan TryGetMember .

Di C#, untuk mengaktifkan perilaku dinamis untuk instans kelas yang berasal dari DynamicObject kelas , Anda harus menggunakan dynamic kata kunci . Untuk informasi selengkapnya, lihat Menggunakan Jenis dinamis.

Di Visual Basic, operasi dinamis didukung oleh pengikatan terlambat. Untuk informasi selengkapnya, lihat Pengikatan Awal dan Terlambat (Visual Basic).

Contoh kode berikut menunjukkan cara membuat instans kelas yang berasal dari DynamicObject kelas .

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

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

Anda juga dapat menambahkan anggota Anda sendiri ke kelas yang DynamicObject berasal dari kelas . Jika kelas Anda menentukan properti dan juga mengambil TrySetMember alih metode , runtime bahasa dinamis (DLR) terlebih dahulu menggunakan pengikat bahasa untuk mencari definisi statis properti di kelas . Jika tidak ada properti seperti itu, DLR memanggil TrySetMember metode .

Kelas mengimplementasikan DynamicObject antarmuka IDynamicMetaObjectProviderDLR , yang memungkinkan Anda berbagi instans DynamicObject kelas antar bahasa yang mendukung model interoperabilitas DLR. Misalnya, Anda dapat membuat instans DynamicObject kelas di C# lalu meneruskannya ke fungsi IronPython. Untuk informasi selengkapnya, lihat Gambaran Umum Runtime Bahasa Dinamis.

Catatan

Jika Anda memiliki skenario sederhana di mana Anda memerlukan objek yang hanya dapat menambahkan dan menghapus anggota pada durasi tetapi tidak perlu menentukan operasi tertentu dan tidak memiliki anggota statis, gunakan ExpandoObject kelas .

Jika Anda memiliki skenario yang lebih canggih di mana Anda perlu menentukan bagaimana objek dinamis berpartisipasi dalam protokol interoperabilitas, atau Anda perlu mengelola penembolokan pengiriman dinamis cepat DLR, buat implementasi IDynamicMetaObjectProvider antarmuka Anda sendiri.

Konstruktor

DynamicObject()

Memungkinkan jenis turunan untuk menginisialisasi instans baru dari jenis tersebut DynamicObject .

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDynamicMemberNames()	Mengembalikan enumerasi semua nama anggota dinamis.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetMetaObject(Expression)	DynamicMetaObject Menyediakan yang dikirim ke metode virtual dinamis. Objek dapat dienkapsulasi di dalam yang lain DynamicMetaObject untuk memberikan perilaku kustom untuk tindakan individual. Metode ini mendukung infrastruktur Dynamic Language Runtime untuk pelaksana bahasa dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryBinaryOperation(BinaryOperationBinder, Object, Object)	Menyediakan implementasi untuk operasi biner. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti penambahan dan perkalian.
TryConvert(ConvertBinder, Object)	Menyediakan implementasi untuk operasi konversi jenis. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi yang mengonversi objek dari satu jenis ke jenis lainnya.
TryCreateInstance(CreateInstanceBinder, Object[], Object)	Menyediakan implementasi untuk operasi yang menginisialisasi instans baru dari objek dinamis. Metode ini tidak dimaksudkan untuk digunakan dalam C# atau Visual Basic.
TryDeleteIndex(DeleteIndexBinder, Object[])	Menyediakan implementasi untuk operasi yang menghapus objek menurut indeks. Metode ini tidak dimaksudkan untuk digunakan dalam C# atau Visual Basic.
TryDeleteMember(DeleteMemberBinder)	Menyediakan implementasi untuk operasi yang menghapus anggota objek. Metode ini tidak dimaksudkan untuk digunakan dalam C# atau Visual Basic.
TryGetIndex(GetIndexBinder, Object[], Object)	Menyediakan implementasi untuk operasi yang mendapatkan nilai menurut indeks. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi pengindeksan.
TryGetMember(GetMemberBinder, Object)	Menyediakan implementasi untuk operasi yang mendapatkan nilai anggota. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti mendapatkan nilai untuk properti.
TryInvoke(InvokeBinder, Object[], Object)	Menyediakan implementasi untuk operasi yang memanggil objek. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti memanggil objek atau delegasi.
TryInvokeMember(InvokeMemberBinder, Object[], Object)	Menyediakan implementasi untuk operasi yang memanggil anggota. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti memanggil metode.
TrySetIndex(SetIndexBinder, Object[], Object)	Menyediakan implementasi untuk operasi yang menetapkan nilai menurut indeks. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi yang mengakses objek dengan indeks tertentu.
TrySetMember(SetMemberBinder, Object)	Menyediakan implementasi untuk operasi yang menetapkan nilai anggota. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti menetapkan nilai untuk properti.
TryUnaryOperation(UnaryOperationBinder, Object)	Menyediakan implementasi untuk operasi unary. Kelas yang berasal dari DynamicObject kelas dapat mengambil alih metode ini untuk menentukan perilaku dinamis untuk operasi seperti negasi, kenaikan, atau penurunan.