DynamicValue Class

Inheritance Hierarchy

SystemObject
  System.DynamicDynamicObject
    TwinCAT.TypeSystemDynamicValue
      TwinCAT.TypeSystemDynamicArrayValue
      TwinCAT.TypeSystemDynamicEnumValue
      TwinCAT.TypeSystemDynamicPointerValue
      TwinCAT.TypeSystemDynamicReferenceValue

Namespace: TwinCAT.TypeSystem
Assembly: TwinCAT.Ads (in TwinCAT.Ads.dll) Version: 7.0.0+e56d35ccc4675faac24789a4aab60071fc61d470

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.
	CachedRawStatic	Gets the value of the cached field values
	DataType	Gets the data type bound to this IValue
	IsPrimitive	Gets a value indicating whether this IValue is a primitive value.
	Logger	Gets the logger object
	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
	CanLog	Determines whether the used logger is enabled for the specified log level.
	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 DynamicObjectGetDynamicMemberNames)
	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 ObjectToString)
	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 DynamicObjectTryConvert(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 DynamicObjectTryGetIndex(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 DynamicObjectTryGetMember(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 DynamicObjectTryInvoke(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 DynamicObjectTryInvokeMember(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 DynamicObjectTrySetIndex(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 DynamicObjectTrySetMember(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.

Fields

	Name	Description
	cachedRaw	The cached (raw) data) of the Root Symbol
	cachedRawStatic	The cached raw static value

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.

Example

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 DynamicSymbol DynamicObject IValue

Beckhoff Automation GmbH & Co. KG 2001-2026