AsnReader.TryReadPrimitiveCharacterStringBytes Method

Definition

Reads the next value as a character with a specified tag, returning the contents as an unprocessed ReadOnlyMemory<T> over the original data.

public bool TryReadPrimitiveCharacterStringBytes (System.Formats.Asn1.Asn1Tag expectedTag, out ReadOnlyMemory<byte> contents);

Parameters

expectedTag
Asn1Tag

The tag to check for before reading.

contents
ReadOnlyMemory<Byte>

On success, receives a ReadOnlyMemory<T> over the original data corresponding to the value of the character string.

Returns

true and advances the reader if the character string value had a primitive encoding, false and does not advance the reader if it had a constructed encoding.

Exceptions

The next value does not have the correct tag.

-or-

The length encoding is not valid under the current encoding rules.

-or-

The contents are not valid under the current encoding rules.

expectedTag.TagClass is Universal, but expectedTag.TagValue is not a character string tag type.

Remarks

This method does not determine if the string used only characters defined by the encoding.

Applies to

Product Versions
.NET 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9
.NET Framework 4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided)
.NET Standard 2.0 (package-provided)

See also