DynamicObject-Klasse

Die DynamicObject-Klasse ermöglicht es Ihnen zu definieren, welche Operationen für dynamische Objekte ausgeführt werden können, und wie solche Operationen ausgeführt werden. Sie können z. B. definieren, was geschieht, wenn Sie versuchen, eine Objekteigenschaft abzurufen oder festzulegen, eine Methode aufzurufen oder mathematische Standardoperationen, z. B. Addition und Multiplikation, ausführen.

Diese Klasse kann nützlich sein, wenn Sie für eine Bibliothek ein zweckmäßigeres Protokoll erstellen möchten. Wenn Benutzer der Bibliothek z. B. Syntax wie Scriptobj.SetProperty("Count", 1) verwenden müssen, können Sie die Möglichkeit bieten, viel einfachere Syntax zu verwenden, etwa scriptobj.Count = 1.

Sie können eine Instanz der DynamicObject-Klasse nicht direkt erstellen. Um das dynamische Verhalten zu implementieren, können Sie von der DynamicObject-Klasse erben und notwendige Methoden überschreiben. Wenn Sie z. B. nur Operationen zum Festlegen und Abrufen von Eigenschaften benötigen, können Sie einfach die Methoden TrySetMember und TryGetMember überschreiben.

Um in C# das dynamische Verhalten für Instanzen von Klassen zu aktivieren, die von der DynamicObject-Klasse abgeleitet werden, müssen Sie das dynamic-Schlüsselwort verwenden. Weitere Informationen finden Sie unter Verwenden des Typs dynamic (C#-Programmierhandbuch).

In Visual Basic werden dynamische Vorgänge durch späte Bindung unterstützt. Weitere Informationen finden Sie unter Frühes und spätes Binden (Visual Basic).

Im folgenden Codebeispiel wird das Erstellen der Instanz einer von der DynamicObject-Klasse abgeleiteten Klasse veranschaulicht.

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

Sie können von der DynamicObject-Klasse abgeleiteten Klassen auch eigene Member hinzufügen. Wenn die Klasse Eigenschaften definiert und auch die TrySetMember-Methode überschreibt, sucht die Dynamic Language Runtime (DLR) sucht zuerst mithilfe des Sprachenbinders nach einer statischen Definition einer Eigenschaft in der Klasse. Wen keine solche Eigenschaft vorhanden ist, ruft die DLR die TrySetMember-Methode auf.

Die DynamicObject-Klasse implementiert der DLR-Schnittstelle IDynamicMetaObjectProvider, die es Ihnen ermöglicht, Instanzen der DynamicObject-Klasse zwischen Sprachen freizugeben, die das DLR-Interoperabilitätsmodell unterstützen. Sie können z. B. in C# eine Instanz der DynamicObject-Klasse erstellen und diese dann an eine IronPython-Funktion übergeben. Weitere Informationen finden Sie in der Übersicht über die Dynamic Language Runtime-Dokumentation auf der CodePlex-Website.

Hinweis

Wenn Sie ein einfaches Szenario haben, in dem Sie ein Objekt benötigen, das nur Member zur Laufzeit hinzufügen und entfernen kann, das aber keine bestimmten Operationen definieren muss und über keine statische Member verfügt, verwenden Sie die ExpandoObject-Klasse. Wenn Sie ein erweitertes Szenario benötigen, indem Sie definieren müssen, wie dynamische Objekte am Interoperabilitätsprotokoll teilnehmen, oder das Zwischenspeichern des schnellen dynamischen DLR-Dispatchs verwalten müssen, erstellen Sie eine eigene Implementierung der IDynamicMetaObjectProvider-Schnittstelle.

Angenommen, Sie möchten alternative Syntax zum Zugreifen auf Werte in einem Wörterbuch bereitstellen, damit Sie sampleDictionary.Text = "Sample text" statt sampleDictionary["Text"] = "Sample text" (sampleDictionary("Text") = "Sample text" in Visual Basic) schreiben können. Auch können Sie diese Syntax als die Groß-/Kleinschreibung nicht beachtend festlegen, sodass sampleDictionary.TextsampleDictionary.text entspricht.

Im folgenden Codebeispiel wird die DynamicObject-Klasse veranschaulicht, die von der DynamicDictionary-Klasse abgeleitet wird. Die DynamicDictionary-Klasse enthält ein Objekt des Dictionary<string, object>-Typs (Dictionary(Of String, Object) in Visual Basic), um die Schlüssel/Wert-Paare zu speichern, und überschreibt die TrySetMember-Methode und TryGetMember-Methode, um die neue Syntax zu unterstützen. Außerdem wird eine Count-Eigenschaft bereitgestellt, die anzeigt, wie viele dynamische Eigenschaften das Wörterbuch enthält.

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

Weitere Beispiele finden Sie unter Creating Wrappers with DynamicObject im Blog häufig gestellter Fragen zu C#.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz