2 // System.Security.Policy.PolicyStatement
\r
5 // Dan Lewis (dihlewis@yahoo.co.uk)
\r
6 // Sebastien Pouliot <sebastien@ximian.com>
9 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
11 // Permission is hereby granted, free of charge, to any person obtaining
12 // a copy of this software and associated documentation files (the
13 // "Software"), to deal in the Software without restriction, including
14 // without limitation the rights to use, copy, modify, merge, publish,
15 // distribute, sublicense, and/or sell copies of the Software, and to
16 // permit persons to whom the Software is furnished to do so, subject to
17 // the following conditions:
19 // The above copyright notice and this permission notice shall be
20 // included in all copies or substantial portions of the Software.
22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
31 using System.Runtime.InteropServices;
32 using System.Security.Permissions;
\r
34 namespace System.Security.Policy {
\r
40 public sealed class PolicyStatement : ISecurityEncodable, ISecurityPolicyEncodable {
42 private PermissionSet perms;
\r
43 private PolicyStatementAttribute attrs;
\r
45 public PolicyStatement (PermissionSet perms) :
46 this (perms, PolicyStatementAttribute.Nothing)
\r
50 public PolicyStatement (PermissionSet perms, PolicyStatementAttribute attrs)
52 if (perms != null) {
\r
53 this.perms = perms.Copy ();
54 this.perms.SetReadOnly (true);
59 public PermissionSet PermissionSet {
\r
62 perms = new PermissionSet (PermissionState.None);
63 perms.SetReadOnly (true);
67 set { perms = value; }
\r
70 public PolicyStatementAttribute Attributes {
\r
71 get { return attrs; }
\r
73 // note: yes it's a flag but all possible values have a corresponding name
75 case PolicyStatementAttribute.Nothing:
76 case PolicyStatementAttribute.Exclusive:
77 case PolicyStatementAttribute.LevelFinal:
78 case PolicyStatementAttribute.All:
82 string msg = Locale.GetText ("Invalid value for {0}.");
83 throw new ArgumentException (String.Format (msg, "PolicyStatementAttribute"));
88 public string AttributeString {
\r
91 case PolicyStatementAttribute.Exclusive:
93 case PolicyStatementAttribute.LevelFinal:
95 case PolicyStatementAttribute.All:
96 return "Exclusive LevelFinal";
103 public PolicyStatement Copy ()
\r
105 return new PolicyStatement (perms, attrs);
\r
108 // ISecurityEncodable
\r
110 public void FromXml (SecurityElement e)
\r
115 public void FromXml (SecurityElement e, PolicyLevel level)
\r
118 throw new ArgumentNullException ("e");
119 if (e.Tag != "PolicyStatement")
120 throw new ArgumentException (Locale.GetText ("Invalid tag."));
123 string attributes = e.Attribute ("Attributes");
\r
124 if (attributes != null) {
\r
125 attrs = (PolicyStatementAttribute) Enum.Parse (
\r
126 typeof (PolicyStatementAttribute), attributes);
\r
129 SecurityElement permissions = e.SearchForChildByTag ("PermissionSet");
\r
130 PermissionSet.FromXml (permissions);
\r
133 public SecurityElement ToXml ()
\r
135 return ToXml (null);
\r
138 public SecurityElement ToXml (PolicyLevel level)
\r
140 SecurityElement element = new SecurityElement ("PolicyStatement");
\r
141 element.AddAttribute ("version", "1");
\r
143 if (attrs != PolicyStatementAttribute.Nothing)
\r
144 element.AddAttribute ("Attributes", attrs.ToString ());
\r
146 element.AddChild (PermissionSet.ToXml ());
\r
153 public override bool Equals (object obj)
157 PolicyStatement ps = (obj as PolicyStatement);
161 return (PermissionSet.Equals (obj) && (attrs == ps.attrs));
165 public override int GetHashCode ()
167 // return same hash code if two PolicyStatement are equals
168 return (PermissionSet.GetHashCode () ^ (int) attrs);
172 internal static PolicyStatement Empty ()
174 return new PolicyStatement (new PermissionSet (PermissionState.None));