Asn1UTF8String Class Reference

Inheritance diagram for Asn1UTF8String:

Public Member Functions
	Asn1UTF8String (System.String data)
	Asn1UTF8String ()
override void	Decode (Asn1OerDecodeBuffer buffer)
virtual void	Decode (Asn1PerDecodeBuffer buffer, long lower, long upper)
override void	Decode (Asn1PerDecodeBuffer buffer)
override void	Decode (Asn1BerDecodeBuffer buffer, bool explicitTagging, int implicitLength)
virtual void	Encode (Asn1PerOutputStream outs, long lower, long upper)
override void	Encode (Asn1PerOutputStream outs)
override void	Encode (Asn1BerOutputStream outs, bool explicitTagging)
override void	Encode (Asn1OerEncodeBuffer buffer)
virtual void	Encode (Asn1PerEncodeBuffer buffer, long lower, long upper)
override void	Encode (Asn1PerEncodeBuffer buffer)
override int	Encode (Asn1BerEncodeBuffer buffer, bool explicitTagging)
void	SetAnyAttribute (String qname, String val)
Static Public Member Functions
static string	Decode (Asn1BerDecodeBuffer buffer, Asn1Tag explicitTag, int implicitLength)
static String	DecodeUTF8 (Asn1OerDecodeBuffer buffer)
static string	DecodeUTF8 (Asn1PerDecodeBuffer buffer)
static void	Encode (Asn1BerOutputStream outs, Asn1Tag explicitTag, string value)
static void	Encode (Asn1OerEncodeBuffer buffer, String value)
static void	Encode (Asn1PerEncodeBuffer buffer, string value)
static int	Encode (Asn1BerEncodeBuffer buffer, Asn1Tag explicitTag, string value)
Static Public Attributes
static new readonly Asn1Tag	_TAG
Protected Member Functions
virtual void	Decode (Asn1OerDecodeBuffer buffer, int length)

Detailed Description

This is a container class for holding the components of an ASN.1 UTF-8 string value.

Constructor & Destructor Documentation

Asn1UTF8String ( )

The default constructor creates an empty time string object.

Asn1UTF8String ( System.String data )

This constructor can be used to set the UTF8 String mValue member variable to the given string value.

Parameters:

data

UTF8 String value

Member Function Documentation

virtual void Decode	(	Asn1OerDecodeBuffer	buffer,
		int	length
	)			`[protected, virtual]`

This method decodes the content of an ASN.1 UTF8String string value that was encoded according to OER. The length is not decoded but is taken to be as given.

Parameters:

buffer

Decode message buffer object

override void Decode ( Asn1OerDecodeBuffer buffer ) [virtual]

This method decodes an ASN.1 UTF8String string value that was encoded according to OER.

Parameters:

buffer

Decode message buffer object

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

virtual void Decode	(	Asn1PerDecodeBuffer	buffer,
		long	lower,
		long	upper
	)			`[virtual]`

This method decodes a sized ASN.1 UTF-8 string value using the packed encoding rules (PER).

Parameters:

	buffer	Decode message buffer object
	lower	Lower bound (inclusive) of size constraint
	upper	Upper bound (inclusive) of size constraint

override void Decode ( Asn1PerDecodeBuffer buffer ) [virtual]

This method decodes an ASN.1 UTF-8 string value using the packed encoding rules (PER). The string is assumed to not contain a size constraint.

Parameters:

buffer

Decode message buffer object

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

override void Decode	(	Asn1BerDecodeBuffer	buffer,
		bool	explicitTagging,
		int	implicitLength
	)			`[virtual]`

This method decodes an ASN.1 UTF-8 string value including the UNIVERSAL tag value and length if explicit tagging is specified. This string type uses variable length character encodings.

Parameters:

	buffer	Decode message buffer object
	explicitTagging	Flag indicating element is explicitly tagged
	implicitLength	Length of contents if implicit

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

static string Decode	(	Asn1BerDecodeBuffer	buffer,
		Asn1Tag	explicitTag,
		int	implicitLength
	)			`[static]`

This method decodes an ASN.1 UTF-8 string value including the UNIVERSAL tag value and length if explicit tagging is specified. This string type uses variable length character encodings.

BER encodes UTF8String, OID-IRI, and RELATIVE-OID-IRI in essentially the same way; this permits sharing of the implementation.

Parameters:

	buffer	Decode message buffer object
	explicitTag	Tag to explicitly match, or null if none
	implicitLength	Length of contents if implicit

static String DecodeUTF8 ( Asn1OerDecodeBuffer buffer ) [static]

This method decodes the content of an ASN.1 UTF8String string value that was encoded according to OER.

Parameters:

buffer

Decode message buffer object

Returns:: The decoded string.

static string DecodeUTF8 ( Asn1PerDecodeBuffer buffer ) [static]

This method decodes an ASN.1 UTF-8 string value using the packed encoding rules (PER).

Parameters:

buffer

Decode message buffer object

virtual void Encode	(	Asn1PerOutputStream	outs,
		long	lower,
		long	upper
	)			`[virtual]`

This method encodes a size-constrained ASN.1 UTF-8 string value using the packed encoding rules (PER). The value to be encoded is stored in the 'mValue' public member variable within this class.

Also throws any exception thrown by the Asn1PerOutputStream.

Parameters:

	outs	PER Output Stream object
	lower	Lower bound (inclusive) of size constraint
	upper	Upper bound (inclusive) of size constraint

Exceptions:

Asn1Exception

Thrown, if operation is failed.

override void Encode ( Asn1PerOutputStream outs ) [virtual]

This method encodes an unconstrained ASN.1 UTF-8 string value using the packed encoding rules (PER). The value to be encoded is stored in the 'mValue' public member variable within this class.

Also throws any exception thrown by the Asn1PerOutputStream.

Parameters:

outs

PER Output Stream object

Exceptions:

Asn1Exception

Thrown, if operation is failed.

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

override void Encode	(	Asn1BerOutputStream	outs,
		bool	explicitTagging
	)			`[virtual]`

This method encodes and writes to the stream an ASN.1 UTF8 string value including the UNIVERSAL tag value and length if explicit tagging is specified. This overloaded version uses the Basic Encoding Rules (BER).

Throws, Exception thrown by C# System.IO.Stream for I/O error

Parameters:

	outs	BER Output Stream object
	explicitTagging	Flag indicating explicit tagging should be done

Exceptions:

Asn1Exception

Thrown, if operation is failed.

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

static void Encode	(	Asn1BerOutputStream	outs,
		Asn1Tag	explicitTag,
		string	value
	)			`[static]`

This method encodes the given string using the BER encoding rules for UTF8String, including the given tag, if provided.

Throws, Exception thrown by C# System.IO.Stream for I/O error

Parameters:

	outs	BER Output Stream object
	explicitTag	Tag to encode, or null for none.
	value	The value to encode. For OID-IRI and RELATIVE-OID-IRI, should not contain whitespace.

Exceptions:

Asn1Exception

Thrown, if operation is failed.

static void Encode	(	Asn1OerEncodeBuffer	buffer,
		String	value
	)			`[static]`

This method encodes an ASN.1 UTF8String according to OER.

Parameters:

	buffer	Encode message buffer object
	value	The value to be encoded.

override void Encode ( Asn1OerEncodeBuffer buffer ) [virtual]

This method encodes a ASN.1 UTF8String according to OER.

Parameters:

buffer

Encode message buffer object

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

virtual void Encode	(	Asn1PerEncodeBuffer	buffer,
		long	lower,
		long	upper
	)			`[virtual]`

This method encodes a size-constrained ASN.1 UTF-8 string value using the packed encoding rules (PER). The value to be encoded is stored in the 'mValue' public member variable within this class.

Parameters:

	buffer	Encode message buffer object
	lower	Lower bound (inclusive) of size constraint
	upper	Upper bound (inclusive) of size constraint

override void Encode ( Asn1PerEncodeBuffer buffer ) [virtual]

This method encodes an unconstrained ASN.1 UTF-8 string value using the packed encoding rules (PER). The value to be encoded is stored in the 'mValue' public member variable within this class.

Parameters:

buffer

Encode message buffer object

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

static void Encode	(	Asn1PerEncodeBuffer	buffer,
		string	value
	)			`[static]`

This method encodes a string using the packed encoding rules (PER) specifie for ASN1. UTF8String. These rules are essentially shared with OID-IRI and RELATIVE-OID-IRI.

Parameters:

	buffer	Encode message buffer object
	value	The value to be encoded. In the case of OID-IRI and RELATIVE-OID-IRI, should not contain whitespace.

override int Encode	(	Asn1BerEncodeBuffer	buffer,
		bool	explicitTagging
	)			`[virtual]`

This method encodes an ASN.1 UTF8 string type. The UNIVERSAL tag value and length is also encoded if explicit tagging is specified.

Parameters:

	buffer	Encode message buffer object
	explicitTagging	Flag indicating explicit tagging should be done

Returns:: Length in octets of encoded component

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

static int Encode	(	Asn1BerEncodeBuffer	buffer,
		Asn1Tag	explicitTag,
		string	value
	)			`[static]`

This method encodes an ASN.1 UTF8 string type. Nearly the same encoding is shared by OID-IRI and RELATIVE-OID_IRI; this method facilitates sharing the implementation.

The UNIVERSAL tag value and length is also encoded if explicit tagging is specified.

Parameters:

	buffer	Encode message buffer object
	explicitTag	Tag to explicitly encode, or null for none.
	value	The value to encode. For OID-IRI and RELATIVE-OID-IRI, whitespace should already have been removed.

Returns:: Length in octets of encoded component

void SetAnyAttribute	(	String	qname,
		String	val
	)

This method will set the anyAttribute type value for given qname and value of XML attribute

Parameters:

	qname	The qualified (prefixed) name
	value	The attribute value

Member Data Documentation

new readonly Asn1Tag _TAG [static]

The _TAG constant describes the universal tag for this data type (UNIVERSAL 12).

Reimplemented from Asn1Type.

Reimplemented in Asn1Real10.

Asn1UTF8String Class Reference

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation