DynamicValue Class

Inheritance Hierarchy

System.Object
  System.Dynamic.DynamicObject
    TwinCAT.TypeSystem.DynamicValue
      TwinCAT.TypeSystem.DynamicArrayValue
      TwinCAT.TypeSystem.DynamicEnumValue
      TwinCAT.TypeSystem.DynamicPointerValue
      TwinCAT.TypeSystem.DynamicReferenceValue
Namespace: TwinCAT.TypeSystem
Assembly: TwinCAT.Ads (in TwinCAT.Ads.dll) Version: 6.0.328+39e3229

C#

public class DynamicValue : DynamicObject, 
    IDynamicValue, IDynamicMetaObjectProvider, IValue, IStructValue, IArrayValue

The DynamicValue type exposes the following members.

Properties

	Name	Description
	Age	Gets the age of the value (last successful read of the value)
	CachedRaw	Gets the cached Raw internal Data.
	DataType	Gets the data type bound to this IValue
	IsPrimitive	Gets a value indicating whether this IValue is a primitive value.
	ParentValue	Gets the parent value.
	ResolvedType	Gets the resolved type.
	Symbol	Gets the symbol that is bound to this value.
	TimeStamp	Gets the Time stamp of the last successful read of the Value.
	UpdateMode	Gets / Sets the update mode
	ValueFactory	The value factory

Methods

	Name	Description
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetDynamicMemberNames	Returns the enumeration of all dynamic member names. (Overrides DynamicObject.GetDynamicMemberNames..)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetMetaObject	Provides a DynamicMetaObject that dispatches to the dynamic virtual methods. The object can be encapsulated inside another DynamicMetaObject to provide custom behavior for individual actions. This method supports the Dynamic Language Runtime infrastructure for language implementers and it is not intended to be used directly from your code. (Inherited from DynamicObject.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Read	Reads the value (via ADS)
	ReadAsync	read as an asynchronous operation.
	ResolveValue	Resolves the Value object to its primitive value.
	setMemberValue	Writes the specified member element.
	ToString	Returns a String that represents this instance. (Overrides Object.ToString..)
	TryBinaryOperation	Provides implementation for binary operations. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as addition and multiplication. (Inherited from DynamicObject.)
	TryConvert	Provides implementation for type conversion operations. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations that convert an object from one type to another. (Overrides DynamicObject.TryConvert(ConvertBinder, Object.).)
	TryCreateInstance	Provides the implementation for operations that initialize a new instance of a dynamic object. This method is not intended for use in C# or Visual Basic. (Inherited from DynamicObject.)
	TryDeleteIndex	Provides the implementation for operations that delete an object by index. This method is not intended for use in C# or Visual Basic. (Inherited from DynamicObject.)
	TryDeleteMember	Provides the implementation for operations that delete an object member. This method is not intended for use in C# or Visual Basic. (Inherited from DynamicObject.)
	TryGetArrayElementValues	Returns Array Element values.
	TryGetIndex	Provides the implementation for operations that get a value by index. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for indexing operations. (Overrides DynamicObject.TryGetIndex(GetIndexBinder, .Object., Object.).)
	TryGetIndexValue(.Int32., Object.)	Reads the specified array element.
	TryGetIndexValue(.Object., Object.)	Tries the get index value.
	TryGetMember	Provides the implementation for operations that get member values. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as getting a value for a property. (Overrides DynamicObject.TryGetMember(GetMemberBinder, Object.).)
	TryGetMemberValue	Tries the get member value.
	TryInvoke	Provides the implementation for operations that invoke an object. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as invoking an object or a delegate. (Overrides DynamicObject.TryInvoke(InvokeBinder, .Object., Object.).)
	TryInvokeMember	Provides the implementation for operations that invoke a member. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as calling a method. (Overrides DynamicObject.TryInvokeMember(InvokeMemberBinder, .Object., Object.).)
	TryResolveValue	Tries to resolves the Value object to its primitive value.
	TrySetIndex	Provides the implementation for operations that set a value by index. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations that access objects by a specified index. (Overrides DynamicObject.TrySetIndex(SetIndexBinder, .Object., Object).)
	TrySetIndexValue(.Int32., Object)	Tries to set the indexed value on Arrays
	TrySetIndexValue(.Object., Object)	Tries to set the indexed value on Arrays
	TrySetMember	Provides the implementation for operations that set member values. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as setting a value for a property. (Overrides DynamicObject.TrySetMember(SetMemberBinder, Object).)
	TrySetMemberValue	Tries to Set a Member/Property Value
	TryUnaryOperation	Provides implementation for unary operations. Classes derived from the DynamicObject class can override this method to specify dynamic behavior for operations such as negation, increment, or decrement. (Inherited from DynamicObject.)
	Write	Writes the value (via ADS)
	WriteAsync	write as an asynchronous operation.

Remarks

The DynamicValue adds dynamic run time behaviour to the IValueValue/IValue. That means e.g. for struct values that .NET Properties are on-the-fly defined and dispatched at runtime just like defined in the structs structs data type definition. Another example is the access of Array Element values through indexes.

Examples

Sample for the dynamic resolution of Symbols and reading values:

Dynamic Symbol access

/// <summary>
/// Defines the entry point of the application.
/// </summary>
/// <param name="args">The arguments.</param>
static async void Main(string[] args)
{
    // Get the AdsAddress from command-line arguments
    AmsAddress address = ArgParser.Parse(args);

    CancellationTokenSource cancelSource = new CancellationTokenSource();
    CancellationToken cancel = cancelSource.Token;

    using (AdsClient client = new AdsClient())
    {
    // Connect to the target device
    client.Connect(address);

    // Usage of "dynamic" Type and Symbols (>= .NET4 only)
    SymbolLoaderSettings settings = new SymbolLoaderSettings(SymbolsLoadMode.DynamicTree);
    IAdsSymbolLoader dynLoader = (IAdsSymbolLoader)SymbolLoaderFactory.Create(client, settings);

Reference

TwinCAT.TypeSystem Namespace

TwinCAT.TypeSystem.DynamicSymbol

System.Dynamic.DynamicObject

TwinCAT.TypeSystem.IValue