	Home About ASN.1 Products Free Software Open Source Documents Services Resources Resellers Customers Careers About Us Contact Us

Com.Objsys.Asn1.Runtime.Asn1GeneralizedTime

Asn1GeneralizedTime Class Reference

Inheritance diagram for Asn1GeneralizedTime:

List of all members.

Detailed Description

This is a container class for holding the components of an ASN.1 generalized time string value.

Public Member Functions

Asn1GeneralizedTime (System.String data, bool useDerRules)

Asn1GeneralizedTime (System.String data)

Asn1GeneralizedTime (bool useDerRules)

Asn1GeneralizedTime ()

override System.Int32 CompareTo (System.Object obj)

override void Decode (Asn1BerDecodeBuffer buffer, bool explicitTagging, int implicitLength)

override void Encode (Asn1XerEncoder buffer, System.String elemName, System.String attribute)

override void Encode (Asn1BerOutputStream outs, bool explicitTagging)

override int Encode (Asn1BerEncodeBuffer buffer, bool explicitTagging)

virtual void EncodeXMLData (Asn1XerEncoder buffer)

override void ParseString (System.String data)

Static Public Attributes

static new readonly Asn1Tag _TAG

Protected Member Functions

internal override bool CompileString ()

Properties

virtual int Century

Constructor & Destructor Documentation

Asn1GeneralizedTime ( )

The default constructor creates an empty time string object.

Asn1GeneralizedTime ( bool useDerRules )

This constructor creates an empty time string object and allows DER encoding rules to be specified.

Parameters:

useDerRules 'true' if time string should be encoded with DER/PER.

Asn1GeneralizedTime ( System.String data )

This version of the constructor can be used to set the string mValue member variable to the given time string. The format of a GeneralizedTime string is YYYYMMDDHHMMSS.n[Z][-HHMM].

Parameters:

data Character string

Asn1GeneralizedTime ( System.String data,

bool useDerRules

)

This version of the constructor can be used to set the string mValue member variable to the given time string and specify DER encoding rules be used to construct the string.

Parameters:

data Character string

useDerRules 'true' if time string should be encoded with DER/PER.

Member Function Documentation

override System.Int32 CompareTo ( System.Object obj ) [virtual]

This method compares this object with Asn1Time class instance or with System.DateTime instance. Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object. Note that the action of this method may differentiate for different inherited Asn1Time classes.

Parameters:

obj the Object to be compared.

Returns:
The difference in Ticks with the specified object.

Reimplemented from Asn1Time.

internal override bool CompileString ( ) [protected, virtual]

Compiles new time string accoring X.680 (clause 41) and ISO 8601.

Returns:
true, if succeed, or false code, if error.

Implements Asn1Time.

override void Decode ( Asn1BerDecodeBuffer buffer,

bool explicitTagging,

int implicitLength

) [virtual]

This method decodes an ASN.1 string value including the UNIVERSAL tag value and length if explicit tagging is specified.

Parameters:

buffer Decode message buffer object

explicitTagging Flag indicating element is explicitly tagged

implicitLength Length of contents if implicit

Reimplemented from Asn1Type.

override void Encode ( Asn1XerEncoder buffer,

System.String elemName,

System.String attribute

) [virtual]

This method encodes ASN.1 Generalized Time string into xsd:dateTime format with element and attribute name tag according to the XML Encoding as specified in the XML schema standard(asn2xsd).

Parameters:

buffer Encode message buffer object

elemName XML element name used to wrap string

attribute XML element attribute value

Reimplemented from Asn1CharString.

override void Encode ( Asn1BerOutputStream outs,

bool explicitTagging

) [virtual]

This method encodes and writes to stream an ASN.1 generalized time 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

Reimplemented from Asn1Type.

override int Encode ( Asn1BerEncodeBuffer buffer,

bool explicitTagging

) [virtual]

This method encodes an ASN.1 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.

virtual void EncodeXMLData ( Asn1XerEncoder buffer ) [virtual]

This method creates XML TimeString from the Asn1 GeneralizedTime String. XML dateTime format YYYY-MM-DDTHH:MM:SS[.SSSS][(Z|(+|-) HH:MM)] Asn1 GeneralizedTime format YYYYMMDDHH[MM[SS[(.|,)SSSS]]][(Z|(+|-)HH(MM))]

Parameters:

buffer String buffer to hold the converted xml time string

Exceptions:

Asn1Exception any exception exist in Asn.1 Generalized Time string

override void ParseString ( System.String data ) [virtual]

This method parses the given time string value. It will throw an exception if the string is not in the valid time format. The valid format of a GeneralizedTime string is YYYYMMDDHHMMSS.n[Z][-HHMM].

Parameters:

data The time string value to be parsed.

Exceptions:

Asn1Exception Thrown, if operation is failed.

Implements Asn1Time.

Member Data Documentation

new readonly Asn1Tag _TAG [static]

The _TAG constant describes the universal tag for this data type (UNIVERSAL 24).
Reimplemented from Asn1Type.

Property Documentation

virtual int Century [get, set]

Gets or Sets the century part (first two digits) of the year component of the time value.
Value: Century part (first two digits) of the year component.
Exceptions:

Asn1Exception Thrown, if operation is failed.

This document may be distributed in any form, electronic
or otherwise, provided that it is distributed in its entirety
and that the copyright and this notice are included.

This file was last modified on 18 Nov 2005.
ASN1C C# Runtime Library, 5.8