2 // System.Security.Permissions.KeyContainerPermission class
5 // Sebastien Pouliot <sebastien@ximian.com>
7 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
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:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
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.
31 using System.Globalization;
32 using System.Runtime.InteropServices;
34 namespace System.Security.Permissions {
38 public sealed class KeyContainerPermission : CodeAccessPermission, IUnrestrictedPermission, IBuiltInPermission {
40 private KeyContainerPermissionAccessEntryCollection _accessEntries;
41 private KeyContainerPermissionFlags _flags;
43 private const int version = 1;
47 public KeyContainerPermission (PermissionState state)
49 if (CheckPermissionState (state, true) == PermissionState.Unrestricted) {
50 _flags = KeyContainerPermissionFlags.AllFlags;
54 public KeyContainerPermission (KeyContainerPermissionFlags flags)
59 public KeyContainerPermission (KeyContainerPermissionFlags flags, KeyContainerPermissionAccessEntry[] accessList)
62 if (accessList != null) {
63 foreach (KeyContainerPermissionAccessEntry kcpae in accessList) {
64 _accessEntries.Add (kcpae);
71 public KeyContainerPermissionAccessEntryCollection AccessEntries {
72 get { return _accessEntries; }
75 public KeyContainerPermissionFlags Flags {
76 get { return _flags; }
81 public override IPermission Copy ()
83 if (_accessEntries.Count == 0)
84 return new KeyContainerPermission (_flags);
86 KeyContainerPermissionAccessEntry[] list = new KeyContainerPermissionAccessEntry [_accessEntries.Count];
87 _accessEntries.CopyTo (list, 0);
88 return new KeyContainerPermission (_flags, list);
91 public override void FromXml (SecurityElement esd)
93 // General validation in CodeAccessPermission
94 CheckSecurityElement (esd, "esd", version, version);
95 // Note: we do not (yet) care about the return value
96 // as we only accept version 1 (min/max values)
98 if (IsUnrestricted (esd)) {
99 _flags = KeyContainerPermissionFlags.AllFlags;
103 _flags = (KeyContainerPermissionFlags) Enum.Parse (
104 typeof (KeyContainerPermissionFlags), esd.Attribute ("Flags"));
109 public override IPermission Intersect (IPermission target)
115 public override bool IsSubsetOf (IPermission target)
120 public bool IsUnrestricted ()
122 return (_flags == KeyContainerPermissionFlags.AllFlags);
125 public override SecurityElement ToXml ()
127 SecurityElement e = Element (version);
128 if (IsUnrestricted ()) {
129 e.AddAttribute ("Unrestricted", "true");
137 public override IPermission Union (IPermission target)
139 KeyContainerPermission kcp = Cast (target);
143 KeyContainerPermissionAccessEntryCollection kcpaec = new KeyContainerPermissionAccessEntryCollection ();
145 foreach (KeyContainerPermissionAccessEntry kcpae in _accessEntries) {
148 // copy second group...
149 foreach (KeyContainerPermissionAccessEntry kcpae in kcp._accessEntries) {
150 // ... but only if not present in first group
151 if (_accessEntries.IndexOf (kcpae) == -1)
155 if (kcpaec.Count == 0)
156 return new KeyContainerPermission ((_flags | kcp._flags));
158 KeyContainerPermissionAccessEntry[] list = new KeyContainerPermissionAccessEntry [kcpaec.Count];
159 kcpaec.CopyTo (list, 0);
160 return new KeyContainerPermission ((_flags | kcp._flags), list);
163 // IBuiltInPermission
164 int IBuiltInPermission.GetTokenIndex ()
166 return (int) BuiltInToken.KeyContainer;
171 private void SetFlags (KeyContainerPermissionFlags flags)
173 if ((flags & KeyContainerPermissionFlags.AllFlags) != 0) {
174 string msg = String.Format (Locale.GetText ("Invalid enum {0}"), flags);
175 throw new ArgumentException (msg, "KeyContainerPermissionFlags");
180 private KeyContainerPermission Cast (IPermission target)
185 KeyContainerPermission kcp = (target as KeyContainerPermission);
187 ThrowInvalidPermission (target, typeof (KeyContainerPermission));