TOP

What's New in the OSS ASN.1 Tools for C#

Applies to: ASN.1/C# 4.5

What's New in ASN.1/C# 4.5

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.5.

New Features

Conformance to Draft ITU-T Recommendation X.jsoner

The ASN.1/C# compiler and runtime library support the JSON Encoding Rules. The existing -json command-line option instructs the compiler to enable support for X.jsoner at runtime.

The JSON codec supports the following encoding instructions:

  • JER:ARRAY
  • JER:BASE64
  • JER:NAME
  • JER:OBJECT
  • JER:TEXT
  • JER:UNWRAPPED
Support for .NET Standard 1.4

The OSS ASN.1 Tools for C# now includes an additional version of the runtime assembly compatible with .NET Standard 1.4. You can use this version of the asn1csrt.dll runtime DLL to develop applications on the following platforms:

To generate C# classes compatible with .NET Standard, specify the -noserializable compiler option.

NOTE: When generating C# classes that will be used with .NET Standard, do not specify the -genschemainfo compiler option. This option generates C# attributes that are not supported by .NET Standard.

New samples

The following new samples for LTE protocols have been added:


What's New in ASN.1/C# 4.4

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.4.

New Features

Support for CXER

The -cxer option has been added to support the Canonical XML Encoding Rules (CXER) in the ASN.1/C# Tools. This option enables generation of the CXER encoder and the XER decoder so CXER messages can be encoded and decoded.

New command-line options

What's New in ASN.1/C# 4.3.1

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.3.1.

New Features

The OSS ASN.1 Tools for C# now includes ASN.1 Studio 8.0. For a summary of the improvements in ASN.1 Studio 8.0, see the Enhancements History section.


What's New in ASN.1/C# 4.3

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.3.

New Features

The following new features have been added:

Support for E-XER

For more information about the limitations that apply to the E-XER encoder/decoder, see the Encoder/Decoder Limitations section.

New command-line option

The -exer command-line option enables generation of code for E-XER.

New runtime option

The RecursionLimit decoder option limits the depth of nested recursive calls when the value of a circularly defined type is decoded.


What's New in ASN.1/C# 4.2

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.2.

New Features

The following new features have been added:

Support for new encoding rules
  • Distinguished Encoding Rules (DER)
  • Canonical Octet Encoding Rules (C-OER)
  • XML Encoding Rules (XER)
New command-line options
Sample Code Generation

The ASN.1 compiler can generate a sample program that shows you how to encode, decode, or print PDU and Value objects for types defined in the schema. To generate a sample program, use the -sampleCode command-line option.

New method

The Copy() method has been added to the PDU classes. The method implements a deep copy of an object.

New runtime options

The JSON encoder now supports the EncodeImpliedValues option which enables encoding of null PDU fields (they imply a default value) in the JSON output.

The ValueNotationFormatter class now supports the PrintImpliedValues which enables printing of null PDU fields (they imply a default value) in the formatted output.

Improvements

The JSON codec now supports an alternative format so that optional fields can be encoded as <key>:null (for example, "DateOfBirth":null).

Improved UTF8 printing and initialization of UTF8String fields. The ASN.1 compiler now generates human-readable strings (instead of byte arrays) to initialize UTF8String fields.


What's New in ASN.1/C# 4.1

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.1.

New Features

The following new features have been added:

Support for JSON Encoding Rules (JSON)
New command-line options
New representation for SET OF/SEQUENCE OF

The new representation provides a separate class wrapping List<>, which is especially useful when handling nested SET OF/SEQUENCE OF.

Improvements

Improved implementation for comparing SET OF/SEQUENCE OF values. You can now compare nested SET OF/SEQUENCE OF on three or more levels.

To facilitate usage of text-based codecs, for example, JSON or XER, the BaseCodec class was separated into two parts: BinaryCodec and TextCodec. Note that existing applications that reference BaseCodec must be changed to reference BinaryCodec.

The compiler now recognizes reserved C# keywords.

Reserved words specified with the -reservedWords compiler option are now case-sensitive.


What's New in ASN.1/C# 4.0

This section provides a summary of the new and enhanced features in the OSS ASN.1 Tools for C# 4.0.

Improvements

With version 4.0, the OSS ASN.1 Tools for C# has been redesigned with a more user-friendly API and better performance.

Users of the OSS ASN.1/C# Tools version 3 will find the architecture and the development process very familiar. However, the API is not compatible with previous versions (3 and earlier), so your existing application code must be modified to use the new API. However, you can install version 4.0 alongside an older version of the OSS ASN.1 Tools for C#; the two versions will peacefully co-exist.

See the Migration Guide for information about upgrading to version 4 and the Comparison Card to see the differences between versions 3 and 4.


This user manual applies to the 4.x releases of the OSSĀ® ASN.1 Tools for C#. For earlier versions, consult the PDF manual available in your product installation.

Copyright © 2017 OSS Nokalva, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior permission of OSS Nokalva, Inc.
Every distributed copy of the OSS® ASN.1 Tools for C# is associated with a specific license and related unique license number. That license determines, among other things, what functions of the OSS ASN.1 Tools for C# are available to you.