mcs/class/System/System.Security.Permissions/StorePermission.cs

   1 //
   2 // System.Security.Permissions.StorePermission class
   3 //
   4 // Author:
   5 //      Sebastien Pouliot  <sebastien@ximian.com>
   6 //
   7 // Copyright (C) 2005 Novell, Inc (http://www.novell.com)
   8 //
   9 // Permission is hereby granted, free of charge, to any person obtaining
  10 // a copy of this software and associated documentation files (the
  11 // "Software"), to deal in the Software without restriction, including
  12 // without limitation the rights to use, copy, modify, merge, publish,
  13 // distribute, sublicense, and/or sell copies of the Software, and to
  14 // permit persons to whom the Software is furnished to do so, subject to
  15 // the following conditions:
  16 //
  17 // The above copyright notice and this permission notice shall be
  18 // included in all copies or substantial portions of the Software.
  19 //
  20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  27 //
  28
  29 #if NET_2_0
  30
  31 using System.Globalization;
  32
  33 namespace System.Security.Permissions {
  34
  35         [Serializable]
  36         public sealed class StorePermission : CodeAccessPermission, IUnrestrictedPermission {
  37
  38                 private const int version = 1;
  39
  40                 private StorePermissionFlags _flags;
  41
  42
  43                 public StorePermission (PermissionState state)
  44                 {
  45                         if (PermissionHelper.CheckPermissionState (state, true) == PermissionState.Unrestricted)
  46                                 _flags = StorePermissionFlags.AllFlags;
  47                         else
  48                                 _flags = StorePermissionFlags.NoFlags;
  49                 }
  50
  51                 public StorePermission (StorePermissionFlags flags)
  52                 {
  53                         // reuse validation by the Flags property
  54                         Flags = flags;
  55                 }
  56
  57
  58                 public StorePermissionFlags Flags {
  59                         get { return _flags; }
  60                         set {
  61                                 if ((value != 0) && (value & StorePermissionFlags.AllFlags) == 0) {
  62                                         string msg = String.Format (Locale.GetText ("Invalid enum {0}"), value);
  63                                         throw new ArgumentException (msg, "StorePermissionFlags");
  64                                 }
  65                                 _flags = value;
  66                         }
  67                 }
  68
  69                 public bool IsUnrestricted ()
  70                 {
  71                         return (_flags == StorePermissionFlags.AllFlags);
  72                 }
  73
  74                 public override IPermission Copy ()
  75                 {
  76                         // buggy behaviour - affects other operations that use Copy
  77                         // reported as FDBK40928
  78                         if (_flags == StorePermissionFlags.NoFlags)
  79                                 return null;
  80
  81                         return new StorePermission (_flags);
  82                 }
  83
  84                 public override IPermission Intersect (IPermission target)
  85                 {
  86                         StorePermission dp = Cast (target);
  87                         if (dp == null)
  88                                 return null;
  89
  90                         if (this.IsUnrestricted () && dp.IsUnrestricted ())
  91                                 return new StorePermission (PermissionState.Unrestricted);
  92                         if (this.IsUnrestricted ())
  93                                 return dp.Copy ();
  94                         if (dp.IsUnrestricted ())
  95                                 return this.Copy ();
  96
  97                         StorePermissionFlags spf = _flags & dp._flags;
  98                         if (spf == StorePermissionFlags.NoFlags)
  99                                 return null;
 100
 101                         return new StorePermission (spf);
 102                 }
 103
 104                 public override IPermission Union (IPermission target)
 105                 {
 106                         StorePermission dp = Cast (target);
 107                         if (dp == null)
 108                                 return this.Copy (); // will return null for NoFlags
 109
 110                         if (this.IsUnrestricted () || dp.IsUnrestricted ())
 111                                 return new StorePermission (PermissionState.Unrestricted);
 112
 113                         StorePermissionFlags spf = _flags | dp._flags;
 114                         if (spf == StorePermissionFlags.NoFlags)
 115                                 return null;
 116
 117                         return new StorePermission (spf);
 118                 }
 119
 120                 public override bool IsSubsetOf (IPermission target)
 121                 {
 122                         StorePermission dp = Cast (target);
 123                         if (dp == null)
 124                                 return (_flags == StorePermissionFlags.NoFlags);
 125
 126                         if (dp.IsUnrestricted ())
 127                                 return true;
 128                         if (this.IsUnrestricted ())
 129                                 return false;
 130
 131                         return ((_flags & ~dp._flags) == 0);
 132                 }
 133
 134                 public override void FromXml (SecurityElement e)
 135                 {
 136                         // General validation in CodeAccessPermission
 137                         PermissionHelper.CheckSecurityElement (e, "e", version, version);
 138                         // Note: we do not (yet) care about the return value
 139                         // as we only accept version 1 (min/max values)
 140
 141                         string s = e.Attribute ("Flags");
 142                         if (s == null)
 143                                 _flags = StorePermissionFlags.NoFlags;
 144                         else
 145                                 _flags = (StorePermissionFlags) Enum.Parse (typeof (StorePermissionFlags), s);
 146                 }
 147
 148                 public override SecurityElement ToXml ()
 149                 {
 150                         SecurityElement e = PermissionHelper.Element (typeof (StorePermission), version);
 151                         if (this.IsUnrestricted ()) {
 152                                 e.AddAttribute ("Unrestricted", Boolean.TrueString);
 153                         } else {
 154                                 e.AddAttribute ("Flags", _flags.ToString ());
 155                         }
 156                         return e;
 157                 }
 158
 159                 // helpers
 160
 161                 private StorePermission Cast (IPermission target)
 162                 {
 163                         if (target == null)
 164                                 return null;
 165
 166                         StorePermission dp = (target as StorePermission);
 167                         if (dp == null) {
 168                                 PermissionHelper.ThrowInvalidPermission (target, typeof (StorePermission));
 169                         }
 170
 171                         return dp;
 172                 }
 173         }
 174 }
 175
 176 #endif