ExpandoObject (Clase)

Para habilitar el enlace en tiempo de ejecución para una instancia de la clase ExpandoObject, debe utilizar la palabra clave dynamic en C#. Para obtener más información, vea Uso de tipo dinámico (Guía de programación de C#).

En Visual Basic, el enlace en tiempo de ejecución admite las operaciones dinámicas. Para obtener más información, vea Enlace en tiempo de compilación y en tiempo de ejecución (Visual Basic).

En el siguiente ejemplo de código se muestra cómo crear una instancia de la clase ExpandoObject.

dynamic sampleObject = new ExpandoObject();

Puede agregar propiedades, métodos y eventos a instancias de la clase ExpandoObject.

En el ejemplo de código siguiente se muestra cómo agregar una nueva propiedad a una instancia de la clase 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

Los métodos representan expresiones lambda que están almacenadas como delegados, que se pueden invocar cuando se necesitan. En el ejemplo de código siguiente se muestra cómo agregar un método que incrementa un valor de la propiedad dinámica.

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

En el siguiente ejemplo de código se explica cómo agregar un evento a una instancia de la clase 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.

Puede pasar instancias de la clase ExpandoObject como parámetros. Observe que estas instancias se tratan como objetos dinámicos en C# y en objetos enlazados en tiempo de ejecución en Visual Basic. Esto significa que no tiene IntelliSense para los miembros de objeto y que no se reciben los errores del compilador cuando llama a los miembros no existentes. Si llama a un miembro que no existe, se produce una excepción.

En el ejemplo de código siguiente se muestra cómo crear y usar un método para imprimir nombres y valores de propiedades.

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.

La clase ExpandoObject implementa la interfaz IDictionary<String, Object>. Esto habilita la enumeración de los miembros agregados a la instancia de la clase ExpandoObject en tiempo de ejecución. Esto puede ser útil si no conoce qué miembros podría tener una instancia en tiempo de compilación.

El siguiente ejemplo de código muestra cómo puede convertir una instancia de la clase ExpandoObject a la interfaz IDictionary<TKey, TValue> y enumerar los miembros de la instancia.

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

En lenguajes que no tienen la sintaxis para eliminar miembros (como C# y Visual Basic), puede eliminar un miembro convirtiendo una instancia de ExpandoObject en la interfaz IDictionary<String, Object> y eliminando después el miembro como un par clave-valor. Esto se muestra en el ejemplo siguiente.

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

La clase ExpandoObject implementa la interfaz INotifyPropertyChanged y puede generar un evento PropertyChanged cuando se agrega, elimina o modifica un miembro. Esto habilita la integración de la clase ExpandoObject con el enlace de datos de Windows Presentation Foundation (WPF) y otros entornos que requieren una notificación sobre los cambios en el contenido del objeto.

En el siguiente ejemplo de código se muestra cómo crear un controlador de eventos para el evento 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);
    }
}