mcs/class/Novell.Directory.Ldap/Novell.Directory.Ldap.Rfc2251/RfcMatchingRuleAssertion.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.Rfc2251.RfcMatchingRuleAssertion.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 using Novell.Directory.Ldap.Asn1;
  34
  35 namespace Novell.Directory.Ldap.Rfc2251
  36 {
  37
  38         /// <summary> Represents an Ldap Matching Rule Assertion.
  39         ///
  40         /// <pre>
  41         /// MatchingRuleAssertion ::= SEQUENCE {
  42         /// matchingRule    [1] MatchingRuleId OPTIONAL,
  43         /// type            [2] AttributeDescription OPTIONAL,
  44         /// matchValue      [3] AssertionValue,
  45         /// dnAttributes    [4] BOOLEAN DEFAULT FALSE }
  46         /// </pre>
  47         /// </summary>
  48         public class RfcMatchingRuleAssertion:Asn1Sequence
  49         {
  50
  51                 //*************************************************************************
  52                 // Constructors for MatchingRuleAssertion
  53                 //*************************************************************************
  54
  55                 /// <summary> Creates a MatchingRuleAssertion with the only required parameter.
  56                 ///
  57                 /// </summary>
  58                 /// <param name="matchValue">The assertion value.
  59                 /// </param>
  60                 public RfcMatchingRuleAssertion(RfcAssertionValue matchValue):this(null, null, matchValue, null)
  61                 {
  62                 }
  63
  64                 /// <summary> Creates a MatchingRuleAssertion.
  65                 ///
  66                 /// The value null may be passed for an optional value that is not used.
  67                 ///
  68                 /// </summary>
  69                 /// <param name="matchValue">The assertion value.
  70                 /// </param>
  71                 /// <param name="matchingRule">Optional matching rule.
  72                 /// </param>
  73                 /// <param name="type">Optional attribute description.
  74                 /// </param>
  75                 /// <param name="dnAttributes">Asn1Boolean value. (default false)
  76                 /// </param>
  77                 public RfcMatchingRuleAssertion(RfcMatchingRuleId matchingRule, RfcAttributeDescription type, RfcAssertionValue matchValue, Asn1Boolean dnAttributes):base(4)
  78                 {
  79                         if (matchingRule != null)
  80                                 add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, 1), matchingRule, false));
  81
  82                         if (type != null)
  83                                 add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, 2), type, false));
  84
  85                         add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, 3), matchValue, false));
  86
  87                         // if dnAttributes if false, that is the default value and we must not
  88                         // encode it. (See RFC 2251 5.1 number 4)
  89                         if (dnAttributes != null && dnAttributes.booleanValue())
  90                                 add(new Asn1Tagged(new Asn1Identifier(Asn1Identifier.CONTEXT, false, 4), dnAttributes, false));
  91                         return ;
  92                 }
  93         }
  94 }