ExpandoObject 类

定义

public ref class ExpandoObject sealed : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::ComponentModel::INotifyPropertyChanged, System::Dynamic::IDynamicMetaObjectProvider

public sealed class ExpandoObject : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>, System.ComponentModel.INotifyPropertyChanged, System.Dynamic.IDynamicMetaObjectProvider

type ExpandoObject = class
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
    interface IDictionary<string, obj>
    interface INotifyPropertyChanged
    interface IDynamicMetaObjectProvider

type ExpandoObject = class
    interface IDynamicMetaObjectProvider
    interface IDictionary<string, obj>
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
    interface INotifyPropertyChanged

Public NotInheritable Class ExpandoObject
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IDynamicMetaObjectProvider, IEnumerable(Of KeyValuePair(Of String, Object)), INotifyPropertyChanged

继承

Object

ExpandoObject

实现

ICollection<KeyValuePair<String,Object>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<String,Object> IEnumerable<KeyValuePair<String,Object>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> IEnumerable INotifyPropertyChanged IDynamicMetaObjectProvider

注解

类 ExpandoObject 使你可以在运行时添加和删除其实例的成员，以及设置和获取这些成员的值。 此类支持动态绑定，因此可以使用标准语法，例如 sampleObject.sampleMember ，而不是更复杂的 sampleObject.GetAttribute("sampleMember")语法。

该 ExpandoObject 类实现标准动态语言运行时 （DLR） 接口 IDynamicMetaObjectProvider，使你可以在支持 DLR 互作性模型的语言之间共享类的 ExpandoObject 实例。 例如，可以在 C# 中创建类的 ExpandoObject 实例，然后将其传递给 IronPython 函数。 有关详细信息，请参阅 动态语言运行时概述 和 ExpandoObject 简介。

该 ExpandoObject 类是动态对象概念的实现，可实现获取、设置和调用成员。 如果要定义具有其自己的动态调度语义的类型，请使用该 DynamicObject 类。 如果要定义动态对象如何参与互作性协议并管理 DLR 快速动态调度缓存，请创建自己的接口实现 IDynamicMetaObjectProvider 。

创建实例

在 C# 中，若要为类的 ExpandoObject 实例启用后期绑定，必须使用 dynamic 关键字。 有关详细信息，请参阅 “使用类型动态”。

在 Visual Basic 中，动态操作由后期绑定支持。 有关详细信息，请参阅早期绑定和后期绑定（Visual Basic）。

下面的代码示例演示如何创建类的 ExpandoObject 实例。

dynamic sampleObject = new ExpandoObject();

Dim sampleObject As Object = New ExpandoObject()

添加新成员

可以将属性、方法和事件添加到类的 ExpandoObject 实例。

下面的代码示例演示如何向类的 ExpandoObject 实例添加新属性。

sampleObject.test = "Dynamic Property";
Console.WriteLine(sampleObject.test);
Console.WriteLine(sampleObject.test.GetType());
// This code example produces the following output:
// Dynamic Property
// System.String

sampleObject.Test = "Dynamic Property"
Console.WriteLine(sampleObject.test)
Console.WriteLine(sampleObject.test.GetType())
' This code example produces the following output:
' Dynamic Property
' System.String

这些方法表示作为委托存储的 lambda 表达式，可以在需要时调用它们。 下面的代码示例演示如何添加递增动态属性值的方法。

sampleObject.number = 10;
sampleObject.Increment = (Action)(() => { sampleObject.number++; });

// Before calling the Increment method.
Console.WriteLine(sampleObject.number);

sampleObject.Increment();

// After calling the Increment method.
Console.WriteLine(sampleObject.number);
// This code example produces the following output:
// 10
// 11

sampleObject.Number = 10
sampleObject.Increment = Function() sampleObject.Number + 1
' Before calling the Increment method.
Console.WriteLine(sampleObject.number)

sampleObject.Increment.Invoke()

' After calling the Increment method.
Console.WriteLine(sampleObject.number)
' This code example produces the following output:
' 10
' 11

下面的代码示例演示如何将事件添加到类的 ExpandoObject 实例。

class Program
{
    static void Main(string[] args)
    {
        dynamic sampleObject = new ExpandoObject();

        // Create a new event and initialize it with null.
        sampleObject.sampleEvent = null;

        // Add an event handler.
        sampleObject.sampleEvent += new EventHandler(SampleHandler);

        // Raise an event for testing purposes.
        sampleObject.sampleEvent(sampleObject, new EventArgs());
   }

    // Event handler.
    static void SampleHandler(object sender, EventArgs e)
    {
        Console.WriteLine("SampleHandler for {0} event", sender);
    }
}
// This code example produces the following output:
// SampleHandler for System.Dynamic.ExpandoObject event.

Module Module1

Sub Main()
    Dim sampleObject As Object = New ExpandoObject()

    ' Create a new event and initialize it with null.
    sampleObject.sampleEvent = Nothing

    ' Add an event handler.
    Dim handler As EventHandler = AddressOf SampleHandler
    sampleObject.sampleEvent =
        [Delegate].Combine(sampleObject.sampleEvent, handler)

    ' Raise an event for testing purposes.
    sampleObject.sampleEvent.Invoke(sampleObject, New EventArgs())

End Sub

' Event handler.
Sub SampleHandler(ByVal sender As Object, ByVal e As EventArgs)
    Console.WriteLine("SampleHandler for {0} event", sender)
End Sub

' This code example produces the following output:
' SampleHandler for System.Dynamic.ExpandoObject event.

End Module

作为参数传递

可以将类的 ExpandoObject 实例作为参数传递。 请注意，这些实例被视为 C# 中的动态对象和 Visual Basic 中的后期绑定对象。 这意味着您无法使用对象成员的 IntelliSense，且在调用不存在的成员时不会收到编译器错误。 如果调用不存在的成员，将发生异常。

下面的代码示例演示如何创建和使用方法打印属性的名称和值。

class Program
{
    static void Main(string[] args)
    {
        dynamic employee, manager;

        employee = new ExpandoObject();
        employee.Name = "John Smith";
        employee.Age = 33;

        manager = new ExpandoObject();
        manager.Name = "Allison Brown";
        manager.Age = 42;
        manager.TeamSize = 10;

        WritePerson(manager);
        WritePerson(employee);
    }
    private static void WritePerson(dynamic person)
    {
        Console.WriteLine("{0} is {1} years old.",
                          person.Name, person.Age);
        // The following statement causes an exception
        // if you pass the employee object.
        // Console.WriteLine("Manages {0} people", person.TeamSize);
    }
}
// This code example produces the following output:
// John Smith is 33 years old.
// Allison Brown is 42 years old.

Sub Main()
    Dim employee, manager As Object

    employee = New ExpandoObject()
    employee.Name = "John Smith"
    employee.Age = 33

    manager = New ExpandoObject()
    manager.Name = "Allison Brown"
    manager.Age = 42
    manager.TeamSize = 10

    WritePerson(manager)
    WritePerson(employee)
End Sub

Private Sub WritePerson(ByVal person As Object)

    Console.WriteLine("{0} is {1} years old.",
                      person.Name, person.Age)
    ' The following statement causes an exception
    ' if you pass the employee object.
    ' Console.WriteLine("Manages {0} people", person.TeamSize)

End Sub

枚举和删除成员

ExpandoObject 类实现 IDictionary<String, Object> 接口。 这样，便可以在运行时枚举添加到类实例 ExpandoObject 的成员。 如果在编译时不知道实例可能具有的成员，这可能很有用。

下面的代码示例演示如何将ExpandoObject类的实例类型转换为IDictionary<TKey,TValue>接口，并列出该实例的成员。

dynamic employee = new ExpandoObject();
employee.Name = "John Smith";
employee.Age = 33;

foreach (var property in (IDictionary<String, Object>)employee)
{
    Console.WriteLine(property.Key + ": " + property.Value);
}
// This code example produces the following output:
// Name: John Smith
// Age: 33

Dim employee As Object = New ExpandoObject()
employee.Name = "John Smith"
employee.Age = 33
For Each member In CType(employee, IDictionary(Of String, Object))
    Console.WriteLine(member.Key & ": " & member.Value)
Next
' This code example produces the following output:
' Name: John Smith
' Age: 33

在没有删除成员语法的语言中（例如 C# 和 Visual Basic），可以通过将ExpandoObject实例隐式转换为IDictionary<String, Object>接口，然后将成员作为键/值对删除。 下面的示例说明了这一点。

dynamic employee = new ExpandoObject();
employee.Name = "John Smith";
((IDictionary<String, Object>)employee).Remove("Name");

Dim employee As Object = New ExpandoObject()
employee.Name = "John Smith"
CType(employee, IDictionary(Of String, Object)).Remove("Name")

接收属性更改通知

该 ExpandoObject 类实现了 INotifyPropertyChanged 接口，并且在添加、删除或修改成员时可引发 PropertyChanged 事件。 这使 ExpandoObject 类能够与 Windows Presentation Foundation (WPF) 数据绑定及其他需要被通知对象内容更改的环境集成。

下面的代码示例演示如何为 PropertyChanged 事件创建事件处理程序。

// Add "using System.ComponentModel;" line
// to the beginning of the file.
class Program
{
    static void Test()
    {
        dynamic employee = new ExpandoObject();
        ((INotifyPropertyChanged)employee).PropertyChanged +=
            new PropertyChangedEventHandler(HandlePropertyChanges);
        employee.Name = "John Smith";
    }

    private static void HandlePropertyChanges(
        object sender, PropertyChangedEventArgs e)
    {
        Console.WriteLine("{0} has changed.", e.PropertyName);
    }
}

' Add "Imports System.ComponentModel" line 
' to the beginning of the file.
Sub Main()
    Dim employee As Object = New ExpandoObject
    AddHandler CType(
        employee, INotifyPropertyChanged).PropertyChanged,
        AddressOf HandlePropertyChanges
    employee.Name = "John Smith"
End Sub

Private Sub HandlePropertyChanges(
       ByVal sender As Object, ByVal e As PropertyChangedEventArgs)
    Console.WriteLine("{0} has changed.", e.PropertyName)
End Sub