/******************************************************************************
* The MIT License
* Copyright (c) 2003 Novell Inc. www.novell.com
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the Software), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*******************************************************************************/
//
// Novell.Directory.Ldap.Asn1.Asn1Tagged.cs
//
// Author:
// Sunil Kumar (Sunilk@novell.com)
//
// (C) 2003 Novell, Inc (http://www.novell.com)
//
using System;
namespace Novell.Directory.Ldap.Asn1
{
/// The Asn1Tagged class can hold a base Asn1Object with a distinctive tag
/// describing the type of that base object. It also maintains a boolean value
/// indicating whether the value should be encoded by EXPLICIT or IMPLICIT
/// means. (Explicit is true by default.)
///
/// If the type is encoded IMPLICITLY, the base types form, length and content
/// will be encoded as usual along with the class type and tag specified in
/// the constructor of this Asn1Tagged class.
///
/// If the type is to be encoded EXPLICITLY, the base type will be encoded as
/// usual after the Asn1Tagged identifier has been encoded.
///
public class Asn1Tagged:Asn1Object
{
/// Sets the Asn1Object tagged value
[CLSCompliantAttribute(false)]
virtual public Asn1Object TaggedValue
{
set
{
this.content = value;
if (!explicit_Renamed && value != null)
{
// replace object's id with new tag.
value.setIdentifier(this.getIdentifier());
}
}
}
/// Returns a boolean value indicating if this object uses
/// EXPLICIT tagging.
///
virtual public bool Explicit
{
get
{
return explicit_Renamed;
}
}
private bool explicit_Renamed;
private Asn1Object content;
/* Constructors for Asn1Tagged
*/
/// Constructs an Asn1Tagged object using the provided
/// AN1Identifier and the Asn1Object.
///
/// The explicit flag defaults to true as per the spec.
///
public Asn1Tagged(Asn1Identifier identifier, Asn1Object object_Renamed):this(identifier, object_Renamed, true)
{
return ;
}
/// Constructs an Asn1Tagged object.
public Asn1Tagged(Asn1Identifier identifier, Asn1Object object_Renamed, bool explicit_Renamed):base(identifier)
{
this.content = object_Renamed;
this.explicit_Renamed = explicit_Renamed;
if (!explicit_Renamed && content != null)
{
// replace object's id with new tag.
content.setIdentifier(identifier);
}
return ;
}
/// Constructs an Asn1Tagged object by decoding data from an
/// input stream.
///
///
/// The decoder object to use when decoding the
/// input stream. Sometimes a developer might want to pass
/// in his/her own decoder object
///
///
/// A byte stream that contains the encoded ASN.1
///
///
[CLSCompliantAttribute(false)]
public Asn1Tagged(Asn1Decoder dec, System.IO.Stream in_Renamed, int len, Asn1Identifier identifier):base(identifier)
{
// If we are decoding an implicit tag, there is no way to know at this
// low level what the base type really is. We can place the content
// into an Asn1OctetString type and pass it back to the application who
// will be able to create the appropriate ASN.1 type for this tag.
content = new Asn1OctetString(dec, in_Renamed, len);
return ;
}
/* Asn1Object implementation
*/
/// Call this method to encode the current instance into the
/// specified output stream using the specified encoder object.
///
///
/// Encoder object to use when encoding self.
///
///
/// The output stream onto which the encoded byte
/// stream is written.
///
public override void encode(Asn1Encoder enc, System.IO.Stream out_Renamed)
{
enc.encode(this, out_Renamed);
return ;
}
/* Asn1Tagged specific methods
*/
/// Returns the Asn1Object stored in this Asn1Tagged object
public Asn1Object taggedValue()
{
return content;
}
/// Return a String representation of this Asn1Object.
public override System.String ToString()
{
if (explicit_Renamed)
{
return base.ToString() + content.ToString();
}
// implicit tagging
return content.ToString();
}
}
}