mcs/class/corlib/System.Security/NamedPermissionSet.cs

   1 //
   2 // System.Security.NamedPermissionSet
   3 //
   4 // Authors:
   5 //      Dan Lewis (dihlewis@yahoo.co.uk)
   6 //      Sebastien Pouliot  <sebastien@ximian.com>
   7 //
   8 // (C) 2002
   9 // Portions (C) 2003, 2004 Motus Technologies Inc. (http://www.motus.com)
  10 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
  11 //
  12 // Permission is hereby granted, free of charge, to any person obtaining
  13 // a copy of this software and associated documentation files (the
  14 // "Software"), to deal in the Software without restriction, including
  15 // without limitation the rights to use, copy, modify, merge, publish,
  16 // distribute, sublicense, and/or sell copies of the Software, and to
  17 // permit persons to whom the Software is furnished to do so, subject to
  18 // the following conditions:
  19 //
  20 // The above copyright notice and this permission notice shall be
  21 // included in all copies or substantial portions of the Software.
  22 //
  23 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  24 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  25 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  26 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  27 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  28 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  29 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  30 //
  31
  32 using System.Security.Permissions;
  33
  34 namespace System.Security {
  35
  36         [Serializable]
  37         public sealed class NamedPermissionSet : PermissionSet {
  38
  39                 private string name;
  40                 private string description;
  41
  42                 // for PolicyLevel (to avoid validation duplication)
  43                 internal NamedPermissionSet ()
  44                         : base ()
  45                 {
  46                 }
  47
  48                 public NamedPermissionSet (string name, PermissionSet set)
  49                         : base (set)
  50                 {
  51                         Name = name;
  52                 }
  53
  54                 public NamedPermissionSet (string name, PermissionState state)
  55                         : base (state)
  56                 {
  57                         Name = name;
  58                 }
  59
  60                 public NamedPermissionSet (NamedPermissionSet set)
  61                         : base (set)
  62                 {
  63                         name = set.name; // name can be null here
  64                         description = set.description;
  65                 }
  66
  67                 public NamedPermissionSet (string name)
  68                         : this (name, PermissionState.None)
  69                 {
  70                 }
  71
  72                 // properties
  73
  74                 public string Description {
  75                         get { return description; }
  76                         set { description = value; }
  77                 }
  78
  79                 public string Name {
  80                         get { return name; }
  81                         set {
  82                                 if ((value == null) || (value == String.Empty)) {
  83                                         throw new ArgumentException (Locale.GetText ("invalid name"));
  84                                 }
  85                                 name = value;
  86                         }
  87                 }
  88
  89                 // methods
  90
  91                 public override PermissionSet Copy ()
  92                 {
  93                         return new NamedPermissionSet (this);
  94                 }
  95
  96                 public NamedPermissionSet Copy (string name)
  97                 {
  98                         NamedPermissionSet nps = new NamedPermissionSet (this);
  99                         nps.Name = name;                // get the new name
 100                         return nps;
 101                 }
 102
 103                 public override void FromXml (SecurityElement e)
 104                 {
 105                         base.FromXml (e);
 106                         // strangely it can import a null Name (bypassing property setter)
 107                         name = e.Attribute ("Name");
 108                         description = e.Attribute ("Description");
 109                         if (description == null)
 110                                 description = String.Empty;
 111                 }
 112
 113                 public override SecurityElement ToXml ()
 114                 {
 115                         SecurityElement se = base.ToXml ();
 116                         if (name != null)
 117                                 se.AddAttribute ("Name", name);
 118                         if (description != null)
 119                                 se.AddAttribute ("Description", description);
 120                         return se;
 121                 }
 122
 123 #if NET_2_0
 124                 public override bool Equals (object obj)
 125                 {
 126                         if (obj == null)
 127                                 return false;
 128                         NamedPermissionSet nps = (obj as NamedPermissionSet);
 129                         if (nps == null)
 130                                 return false;
 131                         // description isn't part of the comparaison
 132                         return ((name == nps.Name) && base.Equals (obj));
 133                 }
 134
 135                 public override int GetHashCode ()
 136                 {
 137                         int hc = base.GetHashCode ();
 138                         // name is part of the hash code (except when null)
 139                         if (name != null)
 140                                 hc ^= name.GetHashCode ();
 141                         // description is never part of the hash code
 142                         return hc;
 143                 }
 144 #endif
 145         }
 146 }