mcs/class/Novell.Directory.Ldap/Novell.Directory.Ldap.Asn1/Asn1SequenceOf.cs

   1 /******************************************************************************
   2 * The MIT License
   3 * Copyright (c) 2003 Novell Inc.  www.novell.com
   4 *
   5 * Permission is hereby granted, free of charge, to any person obtaining  a copy
   6 * of this software and associated documentation files (the Software), to deal
   7 * in the Software without restriction, including  without limitation the rights
   8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 * copies of the Software, and to  permit persons to whom the Software is
  10 * furnished to do so, subject to the following conditions:
  11 *
  12 * The above copyright notice and this permission notice shall be included in
  13 * all copies or substantial portions of the Software.
  14 *
  15 * THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  21 * SOFTWARE.
  22 *******************************************************************************/
  23 //
  24 // Novell.Directory.Ldap.Asn1.Asn1SequenceOf.cs
  25 //
  26 // Author:
  27 //   Sunil Kumar (Sunilk@novell.com)
  28 //
  29 // (C) 2003 Novell, Inc (http://www.novell.com)
  30 //
  31
  32 using System;
  33 namespace Novell.Directory.Ldap.Asn1
  34 {
  35
  36         /// <summary> The Asn1SequenceOf class is used to hold an ordered collection
  37         /// of components with identical type.  This class inherits
  38         /// from the Asn1Structured class which already provides
  39         /// functionality to hold multiple Asn1 components.
  40         /// </summary>
  41         [CLSCompliantAttribute(true)]
  42         public class Asn1SequenceOf:Asn1Structured
  43         {
  44
  45                 /// <summary> ASN.1 SEQUENCE OF tag definition.</summary>
  46                 public const int TAG = 0x10;
  47
  48                 /// <summary> ID is added for Optimization.
  49                 ///
  50                 /// ID needs only be one Value for every instance,
  51                 /// thus we create it only once.
  52                 /// </summary>
  53                 public static readonly Asn1Identifier ID = new Asn1Identifier(Asn1Identifier.UNIVERSAL, true, TAG);
  54
  55                 /* Constructors for Asn1SequenceOf
  56                 */
  57
  58                 /// <summary> Constructs an Asn1SequenceOf object with no actual
  59                 /// Asn1Objects in it. Assumes a default size of 5 elements.
  60                 /// </summary>
  61                 public Asn1SequenceOf():base(ID)
  62                 {
  63                         return ;
  64                 }
  65
  66
  67                 /// <summary> Constructs an Asn1SequenceOf object with the specified
  68                 /// number of placeholders for Asn1Objects. However there
  69                 /// are no actual Asn1Objects in this SequenceOf object.
  70                 ///
  71                 /// </summary>
  72                 /// <param name="size">Specifies the initial size of the collection.
  73                 /// </param>
  74                 public Asn1SequenceOf(int size):base(ID, size)
  75                 {
  76                         return ;
  77                 }
  78
  79
  80                 /// <summary> A copy constructor which creates an Asn1SequenceOf from an
  81                 /// instance of Asn1Sequence.
  82                 ///
  83                 /// Since SEQUENCE and SEQUENCE_OF have the same identifier, the decoder
  84                 /// will always return a SEQUENCE object when it detects that identifier.
  85                 /// In order to take advantage of the Asn1SequenceOf type, we need to be
  86                 /// able to construct this object when knowingly receiving an
  87                 /// Asn1Sequence.
  88                 /// </summary>
  89                 public Asn1SequenceOf(Asn1Sequence sequence):base(ID, sequence.toArray(), sequence.size())
  90                 {
  91                         return ;
  92                 }
  93
  94
  95                 /// <summary> Constructs an Asn1SequenceOf object by decoding data from an
  96                 /// input stream.
  97                 ///
  98                 /// </summary>
  99                 /// <param name="dec">The decoder object to use when decoding the
 100                 /// input stream.  Sometimes a developer might want to pass
 101                 /// in his/her own decoder object
 102                 ///
 103                 /// </param>
 104                 /// <param name="in">A byte stream that contains the encoded ASN.1
 105                 ///
 106                 /// </param>
 107                 [CLSCompliantAttribute(false)]
 108                 public Asn1SequenceOf(Asn1Decoder dec, System.IO.Stream in_Renamed, int len):base(ID)
 109                 {
 110                         decodeStructured(dec, in_Renamed, len);
 111                         return ;
 112                 }
 113
 114
 115                 /* Asn1SequenceOf specific methods
 116                 */
 117
 118                 /// <summary> Returns a String representation of this Asn1SequenceOf object</summary>
 119                 [CLSCompliantAttribute(false)]
 120                 public override System.String ToString()
 121                 {
 122                         return base.toString("SEQUENCE OF: { ");
 123                 }
 124         }
 125 }