Version 3.0.5973.0
TcHmiSrvExtNet.Core version 3.0.5973.0 was released on April 23, 2024.
New features (breaking changes) in this release
- The following references were updated:
- ReferenceOld versionNew versionMicrosoft.VisualStudio.Threading17.2.3217.8.14Newtonsoft.Json13.0.113.0.3Newtonsoft.Json.Schema3.0.143.0.15System.Text.Json6.0.58.0.0
- Class ExportSymbolAttribute and enum Visibility were added to export symbols and their JSON schemas based on .NET types to the Config.json and Schema.json of TwinCAT HMI server extensions. In contrast to dynamic symbols, these symbols aren't created dynamically at runtime, but statically at compile time by an MSBuild task contained in the NuGet package Beckhoff.TwinCAT.HMI.TcHmiSrvExtNet.Core.SDK. This class replaces the TcHmiSchemaGenerator.CSharpAttributes.TcHmiExportSymbolAttribute from the TcHmiSchemaGenerator.dll.
- Enum member ValueTypeUInt64 was added and will be automatically set when using the following methods:
- The following method was added to get an UInt64 using the specified IFormatProvider if property ValueType is ValueTypeUInt64:
- Property CommandExtensionData was added.
- The following methods were added to change the friendly name of the TwinCAT HMI server extension:
- ITcHmiSrvExtAsyncHostSetFriendlyName(Context, String)
- ITcHmiSrvExtAsyncHostSetFriendlyNameAsync(Context, String)
- The following methods were added to return an empty String instead of Name if the specified localization cannot be found in the language JSON file of the TwinCAT HMI server extension at the moment:
- ITcHmiSrvExtAsyncHostTryLocalize(Context, ILocalizable)
- ITcHmiSrvExtAsyncHostTryLocalizeAsync(Context, ILocalizable)
- TcHmiAsyncLoggerTryLocalize(ITcHmiSrvExtAsyncHost, Context, String, String)
- TcHmiAsyncLoggerTryLocalizeAsync(ITcHmiSrvExtAsyncHost, Context, String, String)
- TcHmiAsyncLoggerTryLocalize(Context, String, String)
- TcHmiAsyncLoggerTryLocalizeAsync(Context, String, String)
- TcHmiAsyncLoggerTryLocalize(String, String)
- TcHmiAsyncLoggerTryLocalizeAsync(String, String)
- Property ValueIsNumber also returns true if property ValueType is ValueTypeUInt64.
- Enum Int64ParseHandling was added to control how values of type Int64 and UInt64 are parsed when writing JSON text using a TcHmiJsonSerializer.
- Property TcHmiJsonSerializerInt64ParseHandling was added to control how values of type Int64 and UInt64 are parsed when writing JSON text.
- The following methods now return void instead of ErrorValue because they always returned HMI_SUCCESS:
- ITcHmiSrvExtAsyncHostUnregisterListener(Context, IListener)
- ITcHmiSrvExtAsyncHostUnregisterListenerAsync(Context, IListener)
- Property TcHmiApplicationSettings was added to pass additional settings when initializing TwinCAT HMI server extensions.
- Type RecursiveValueResolver
now also supports resolving Values containing an
instance of type Alarm, Event or Message.
This also affects calling methods ValueExtensionsResolveBy(Value, QueueString), ValueExtensionsResolveBy(Value, String), ValueExtensionsTryResolveBy(Value, QueueString, Value) and ValueExtensionsTryResolveBy(Value, String, Value). - The following methods, that are marked with the ObsoleteAttribute in the prior version of this API were removed: