/// <summary>
/// Adds explicitly tagged type. Explicit (EXPLICIT OPTIONAL) must have at least one primitive or constructed nested type.
/// </summary>
/// <param name="explicitTag">
/// Explicit tag number. This number equals to tag number in square brackets in ASN module definition of EXPLICIT.
/// </param>
/// <param name="value">
/// Value to encode.
/// </param>
/// <param name="mustEncode">
/// Specifies if data in <strong>value</strong> parameter must be encoded or not. See Remarks for more details.
/// </param>
/// <exception cref="ArgumentNullException">
/// <strong>value</strong> parameter is null.
/// </exception>
/// <exception cref="InvalidDataException">
/// <strong>value</strong> is not encoded.
/// </exception>
/// <returns>Current instance with added value.</returns>
/// <remarks>
/// If <strong>mustEncode</strong> parameter is set to <strong>true</strong>, then data in <strong>value</strong> parameter
/// is untagged. If <strong>mustEncode</strong> parameter is set to <strong>false</strong>, then data in <strong>value</strong>
/// parameter is explicitly tagged and only tag name change is necessary. Caller must have knowledge in advance if value is tagged or not.
/// If <strong>mustEncode</strong> parameter is set to <strong>false</strong> and value passed in <strong>value</strong> parameter
/// is untagged, invalid type will be produced.
/// </remarks>
public Asn1Builder AddExplicit(Byte explicitTag, Byte[] value, Boolean mustEncode)
{
if (value == null)
{
throw new ArgumentNullException(nameof(value));
}
if (mustEncode)
{
_rawData.AddRange(Asn1Utils.Encode(value, (Byte)(0xa0 + explicitTag)));
}
else
{
var asn = new Asn1Reader(value);
asn.BuildOffsetMap();
var valueCopy = value.ToArray();
valueCopy[0] = (Byte)(0xa0 + explicitTag);
_rawData.AddRange(valueCopy);
}
return(this);
}
/// <summary>
/// Gets ASN.1-encoded byte array that represents current state of builder wrapped using outer ASN.1 type.
/// </summary>
/// <param name="outerTag">
/// Outer type to wrap current state of builder. Outer type must not by the type that is used in primitive form only.
/// Default outer tag is constructed SEQUENCE (0x30 or decimal 48).
/// </param>
/// <returns>
/// ASN.1-encoded byte array.
/// </returns>
public Byte[] GetEncoded(Byte outerTag = 0x30)
{
return(Asn1Utils.Encode(_rawData.ToArray(), outerTag));
}