System.Formats.Asn1 11.0.0-rc.3.26522.148
About
Provides functionality for parsing, encoding, and decoding data using Abstract Syntax Notation One (ASN.1). ASN.1 is a standard interface description language for defining data structures that can be serialized and deserialized in a cross-platform way.
Key Features
- Parse ASN.1 data into .NET types.
- Encode .NET types into ASN.1 format.
- Support for BER, CER, DER: Handles Basic Encoding Rules (BER), Canonical Encoding Rules (CER), and Distinguished Encoding Rules (DER).
How to Use
Parsing ASN.1 data:
using System.Formats.Asn1;
using System.Numerics;
// Sample ASN.1 encoded data (DER format)
byte[] asn1Data = [0x30, 0x09, 0x02, 0x01, 0x01, 0x02, 0x01, 0x02, 0x02, 0x01, 0x03];
// Create an AsnReader to parse the data
AsnReader reader = new(asn1Data, AsnEncodingRules.DER);
// Parse the sequence
AsnReader sequenceReader = reader.ReadSequence();
// Read integers from the sequence
BigInteger firstInt = sequenceReader.ReadInteger();
BigInteger secondInt = sequenceReader.ReadInteger();
BigInteger thirdInt = sequenceReader.ReadInteger();
Console.WriteLine($"First integer: {firstInt}");
Console.WriteLine($"Second integer: {secondInt}");
Console.WriteLine($"Third integer: {thirdInt}");
// First integer: 1
// Second integer: 2
// Third integer: 3
Decoding ASN.1 data using AsnDecoder:
using System.Formats.Asn1;
using System.Numerics;
using System.Text;
// Sample ASN.1 encoded data
byte[] booleanData = [0x01, 0x01, 0xFF]; // BOOLEAN TRUE
byte[] integerData = [0x02, 0x01, 0x05]; // INTEGER 5
byte[] octetStringData = [0x04, 0x03, 0x41, 0x42, 0x43]; // OCTET STRING "ABC"
byte[] objectIdentifierData = [0x06, 0x03, 0x2A, 0x03, 0x04]; // OBJECT IDENTIFIER 1.2.3.4
byte[] utf8StringData = [0x0C, 0x05, 0x48, 0x65, 0x6C, 0x6C, 0x6F]; // UTF8String "Hello"
int bytesConsumed;
bool booleanValue = AsnDecoder.ReadBoolean(booleanData, AsnEncodingRules.DER, out bytesConsumed);
Console.WriteLine($"Decoded BOOLEAN value: {booleanValue}, Bytes consumed: {bytesConsumed}");
// Decoded BOOLEAN value: True, Bytes consumed: 3
BigInteger integerValue = AsnDecoder.ReadInteger(integerData, AsnEncodingRules.DER, out bytesConsumed);
Console.WriteLine($"Decoded INTEGER value: {integerValue}, Bytes consumed: {bytesConsumed}");
// Decoded INTEGER value: 5, Bytes consumed: 3
byte[] octetStringValue = AsnDecoder.ReadOctetString(octetStringData, AsnEncodingRules.DER, out bytesConsumed);
Console.WriteLine($"Decoded OCTET STRING value: {Encoding.ASCII.GetString(octetStringValue)}, Bytes consumed: {bytesConsumed}");
// Decoded OCTET STRING value: ABC, Bytes consumed: 5
string objectIdentifierValue = AsnDecoder.ReadObjectIdentifier(objectIdentifierData, AsnEncodingRules.DER, out bytesConsumed);
Console.WriteLine($"Decoded OBJECT IDENTIFIER value: {objectIdentifierValue}, Bytes consumed: {bytesConsumed}");
// Decoded OBJECT IDENTIFIER value: 1.2.3.4, Bytes consumed: 5
string utf8StringValue = AsnDecoder.ReadCharacterString(utf8StringData, AsnEncodingRules.DER, UniversalTagNumber.UTF8String, out bytesConsumed);
Console.WriteLine($"Decoded UTF8String value: {utf8StringValue}, Bytes consumed: {bytesConsumed}");
// Decoded UTF8String value: Hello, Bytes consumed: 7
Encoding ASN.1 data:
// Create an AsnWriter to encode data
AsnWriter writer = new(AsnEncodingRules.DER);
// Create a scope for the sequence
using (AsnWriter.Scope scope = writer.PushSequence())
{
// Write integers to the sequence
writer.WriteInteger(1);
writer.WriteInteger(2);
writer.WriteInteger(3);
}
// Get the encoded data
byte[] encodedData = writer.Encode();
Console.WriteLine($"Encoded ASN.1 Data: {BitConverter.ToString(encodedData)}");
// Encoded ASN.1 Data: 30-09-02-01-01-02-01-02-02-01-03
Main Types
The main types provided by this library are:
System.Formats.Asn1.AsnReaderSystem.Formats.Asn1.AsnWriterSystem.Formats.Asn1.AsnDecoderSystem.Formats.Asn1.AsnEncodingRules
Additional Documentation
- API documentation
- X.680 - Abstract Syntax Notation One (ASN.1): Specification of basic notation
- X.690 - ASN.1 encoding rules: Specification of Basic Encoding Rules (BER), Canonical Encoding Rules (CER) and Distinguished Encoding Rules (DER)
Feedback & Contributing
System.Formats.Asn1 is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Showing the top 20 packages that depend on System.Formats.Asn1.
| Packages | Downloads |
|---|---|
|
System.Security.Cryptography.Pkcs
Provides support for PKCS and CMS algorithms.
Commonly Used Types:
System.Security.Cryptography.Pkcs.EnvelopedCms
|
39 |
|
System.Security.Cryptography.OpenSsl
Provides cryptographic algorithm implementations and key management for non-Windows systems with OpenSSL.
Commonly Used Types:
System.Security.Cryptography.RSAOpenSsl
When using NuGet 3.x this package requires at least version 3.4.
|
38 |
|
System.Security.Cryptography.Cng
Provides cryptographic algorithm implementations and key management with Windows Cryptographic Next Generation API (CNG).
Commonly Used Types:
System.Security.Cryptography.RSACng
System.Security.Cryptography.ECDsaCng
System.Security.Cryptography.CngKey
When using NuGet 3.x this package requires at least version 3.4.
|
38 |
|
System.Security.Cryptography.Pkcs
Provides support for PKCS and CMS algorithms.
Commonly Used Types:
System.Security.Cryptography.Pkcs.EnvelopedCms
|
38 |
|
Microsoft.Bcl.Cryptography
Provides support for some cryptographic primitives for .NET Framework and .NET Standard.
|
38 |
|
System.Security.Cryptography.OpenSsl
Provides cryptographic algorithm implementations and key management for non-Windows systems with OpenSSL.
Commonly Used Types:
System.Security.Cryptography.RSAOpenSsl
When using NuGet 3.x this package requires at least version 3.4.
|
37 |
|
System.Security.Cryptography.Cng
Provides cryptographic algorithm implementations and key management with Windows Cryptographic Next Generation API (CNG).
Commonly Used Types:
System.Security.Cryptography.RSACng
System.Security.Cryptography.ECDsaCng
System.Security.Cryptography.CngKey
When using NuGet 3.x this package requires at least version 3.4.
|
37 |
|
System.Security.Cryptography.Pkcs
Provides support for PKCS and CMS algorithms.
Commonly Used Types:
System.Security.Cryptography.Pkcs.EnvelopedCms
|
37 |
|
System.Security.Cryptography.Pkcs
Provides support for PKCS and CMS algorithms.
Commonly Used Types:
System.Security.Cryptography.Pkcs.EnvelopedCms
When using NuGet 3.x this package requires at least version 3.4.
|
37 |
https://go.microsoft.com/fwlink/?LinkID=799421
.NET 10.0
- No dependencies.
.NET 11.0
- No dependencies.
.NET Framework 4.6.2
- System.Memory (>= 4.6.3)
- System.ValueTuple (>= 4.6.2)
.NET Standard 2.0
- System.Memory (>= 4.6.3)
| Version | Downloads | Last updated |
|---|---|---|
| 11.0.0 | 3 | 11/10/2026 |
| 11.0.0-rc.3.26522.148 | 4 | 10/30/2026 |
| 11.0.0-rc.2.26504.105 | 5 | 10/15/2026 |
| 11.0.0-rc.1.26425.128 | 7 | 09/15/2026 |
| 11.0.0-preview.7.26381.103 | 9 | 08/12/2026 |
| 11.0.0-preview.6.26359.118 | 12 | 07/18/2026 |
| 11.0.0-preview.5.26302.115 | 11 | 06/12/2026 |
| 11.0.0-preview.4.26230.115 | 15 | 05/16/2026 |
| 11.0.0-preview.3.26207.106 | 17 | 04/24/2026 |
| 11.0.0-preview.2.26159.112 | 18 | 03/12/2026 |
| 11.0.0-preview.1.26104.118 | 18 | 02/19/2026 |
| 10.0.15 | 3 | 11/10/2026 |
| 10.0.14 | 4 | 10/30/2026 |
| 10.0.13 | 5 | 10/21/2026 |
| 10.0.12 | 7 | 09/15/2026 |
| 10.0.11 | 10 | 08/12/2026 |
| 10.0.10 | 10 | 07/18/2026 |
| 10.0.9 | 14 | 06/12/2026 |
| 10.0.8 | 12 | 05/16/2026 |
| 10.0.7 | 19 | 04/24/2026 |
| 10.0.6 | 19 | 04/24/2026 |
| 10.0.5 | 22 | 03/12/2026 |
| 10.0.4 | 21 | 03/12/2026 |
| 10.0.3 | 19 | 02/19/2026 |
| 10.0.2 | 23 | 01/17/2026 |
| 10.0.1 | 25 | 12/10/2025 |
| 10.0.0 | 26 | 12/10/2025 |
| 10.0.0-rc.2.25502.107 | 23 | 10/26/2025 |
| 10.0.0-rc.1.25451.107 | 31 | 09/10/2025 |
| 10.0.0-preview.7.25380.108 | 28 | 09/05/2025 |
| 10.0.0-preview.6.25358.103 | 28 | 07/30/2025 |
| 10.0.0-preview.5.25277.114 | 31 | 07/30/2025 |
| 10.0.0-preview.4.25258.110 | 30 | 05/22/2025 |
| 10.0.0-preview.3.25171.5 | 34 | 05/22/2025 |
| 10.0.0-preview.2.25163.2 | 33 | 04/01/2025 |
| 10.0.0-preview.1.25080.5 | 31 | 02/27/2025 |
| 9.0.23 | 3 | 11/10/2026 |
| 9.0.22 | 4 | 10/30/2026 |
| 9.0.21 | 5 | 10/21/2026 |
| 9.0.20 | 7 | 09/15/2026 |
| 9.0.19 | 9 | 08/12/2026 |
| 9.0.18 | 11 | 07/18/2026 |
| 9.0.17 | 14 | 06/12/2026 |
| 9.0.16 | 12 | 05/16/2026 |
| 9.0.15 | 18 | 04/24/2026 |
| 9.0.14 | 17 | 03/12/2026 |
| 9.0.13 | 20 | 02/19/2026 |
| 9.0.12 | 22 | 01/17/2026 |
| 9.0.11 | 27 | 12/10/2025 |
| 9.0.10 | 29 | 10/26/2025 |
| 9.0.9 | 31 | 09/10/2025 |
| 9.0.8 | 32 | 09/05/2025 |
| 9.0.7 | 33 | 07/30/2025 |
| 9.0.6 | 33 | 07/30/2025 |
| 9.0.5 | 34 | 05/22/2025 |
| 9.0.4 | 34 | 05/22/2025 |
| 9.0.3 | 35 | 04/01/2025 |
| 9.0.2 | 35 | 02/27/2025 |
| 9.0.1 | 36 | 02/27/2025 |
| 9.0.0 | 36 | 02/27/2025 |
| 9.0.0-rc.2.24473.5 | 34 | 02/27/2025 |
| 9.0.0-rc.1.24431.7 | 36 | 02/27/2025 |
| 9.0.0-preview.7.24405.7 | 37 | 02/27/2025 |
| 9.0.0-preview.6.24327.7 | 34 | 02/27/2025 |
| 9.0.0-preview.5.24306.7 | 34 | 02/27/2025 |
| 9.0.0-preview.4.24266.19 | 36 | 02/27/2025 |
| 9.0.0-preview.3.24172.9 | 32 | 02/27/2025 |
| 9.0.0-preview.2.24128.5 | 36 | 02/27/2025 |
| 9.0.0-preview.1.24080.9 | 34 | 02/27/2025 |
| 8.0.2 | 36 | 02/27/2025 |
| 8.0.1 | 36 | 02/27/2025 |
| 8.0.0 | 36 | 02/27/2025 |
| 8.0.0-rc.2.23479.6 | 34 | 02/27/2025 |
| 8.0.0-rc.1.23419.4 | 35 | 02/27/2025 |
| 8.0.0-preview.7.23375.6 | 32 | 02/27/2025 |
| 8.0.0-preview.6.23329.7 | 33 | 02/27/2025 |
| 8.0.0-preview.5.23280.8 | 34 | 02/27/2025 |
| 8.0.0-preview.4.23259.5 | 35 | 02/27/2025 |
| 8.0.0-preview.3.23174.8 | 32 | 02/27/2025 |
| 8.0.0-preview.2.23128.3 | 32 | 02/27/2025 |
| 8.0.0-preview.1.23110.8 | 33 | 02/27/2025 |
| 7.0.0 | 36 | 02/27/2025 |
| 7.0.0-rc.2.22472.3 | 34 | 02/27/2025 |
| 7.0.0-rc.1.22426.10 | 35 | 02/27/2025 |
| 7.0.0-preview.7.22375.6 | 32 | 02/27/2025 |
| 7.0.0-preview.6.22324.4 | 34 | 02/27/2025 |
| 7.0.0-preview.5.22301.12 | 36 | 02/27/2025 |
| 7.0.0-preview.4.22229.4 | 32 | 02/27/2025 |
| 7.0.0-preview.3.22175.4 | 35 | 02/27/2025 |
| 7.0.0-preview.2.22152.2 | 33 | 02/27/2025 |
| 7.0.0-preview.1.22076.8 | 34 | 02/27/2025 |
| 6.0.1 | 35 | 02/27/2025 |
| 6.0.0 | 36 | 02/27/2025 |
| 6.0.0-rc.2.21480.5 | 32 | 02/27/2025 |
| 6.0.0-rc.1.21451.13 | 36 | 02/27/2025 |
| 6.0.0-preview.7.21377.19 | 31 | 02/27/2025 |
| 6.0.0-preview.6.21352.12 | 33 | 02/27/2025 |
| 6.0.0-preview.5.21301.5 | 32 | 02/27/2025 |
| 6.0.0-preview.4.21253.7 | 35 | 02/27/2025 |
| 6.0.0-preview.3.21201.4 | 32 | 02/27/2025 |
| 6.0.0-preview.2.21154.6 | 32 | 02/27/2025 |
| 6.0.0-preview.1.21102.12 | 36 | 02/27/2025 |
| 5.0.0 | 36 | 02/27/2025 |
| 5.0.0-rc.2.20475.5 | 32 | 02/27/2025 |
| 5.0.0-rc.1.20451.14 | 32 | 02/27/2025 |
| 5.0.0-preview.8.20407.11 | 33 | 02/27/2025 |
| 5.0.0-preview.7.20364.11 | 36 | 02/27/2025 |