The Labs \ Source Viewer \ SSCLI \ System.Security.Permissions \ UIPermission

  1. // ==++==
  2. //
  3. //
  4. // Copyright (c) 2006 Microsoft Corporation. All rights reserved.
  5. //
  6. // The use and distribution terms for this software are contained in the file
  7. // named license.txt, which can be found in the root of this distribution.
  8. // By using this software in any fashion, you are agreeing to be bound by the
  9. // terms of this license.
  10. //
  11. // You must not remove this notice, or any other, from this software.
  12. //
  13. //
  14. // ==--==
  15. // UIPermission.cs
  16. //
  17. namespace System.Security.Permissions
  18. {
  19.     using System;
  20.     using System.Security;
  21.     using System.Security.Util;
  22.     using System.IO;
  23.     using System.Runtime.Serialization;
  24.     using System.Reflection;
  25.     using System.Collections;
  26.     using System.Globalization;
  27.    
  28.     [Serializable()]
  29.     [System.Runtime.InteropServices.ComVisible(true)]
  30.     public enum UIPermissionWindow
  31.     {
  32.         // No window use allowed at all.
  33.         NoWindows = 0,
  34.        
  35.         // Only allow safe subwindow use (for embedded components).
  36.         SafeSubWindows = 1,
  37.        
  38.         // Safe top-level window use only (see specification for details).
  39.         SafeTopLevelWindows = 2,
  40.        
  41.         // All windows and all event may be used.
  42.         AllWindows = 3
  43.        
  44.     }
  45.    
  46.     [Serializable()]
  47.     [System.Runtime.InteropServices.ComVisible(true)]
  48.     public enum UIPermissionClipboard
  49.     {
  50.         // No clipboard access is allowed.
  51.         NoClipboard = 0,
  52.        
  53.         // Paste from the same app domain only.
  54.         OwnClipboard = 1,
  55.        
  56.         // Any clipboard access is allowed.
  57.         AllClipboard = 2
  58.        
  59.     }
  60.    
  61.    
  62.     [System.Runtime.InteropServices.ComVisible(true)]
  63.     [Serializable()]
  64.     public sealed class UIPermission : CodeAccessPermission, IUnrestrictedPermission, IBuiltInPermission
  65.     {
  66.         //------------------------------------------------------
  67.         //
  68.         // PRIVATE STATE DATA
  69.         //
  70.         //------------------------------------------------------
  71.        
  72.         private UIPermissionWindow m_windowFlag;
  73.         private UIPermissionClipboard m_clipboardFlag;
  74.        
  75.         //------------------------------------------------------
  76.         //
  77.         // PUBLIC CONSTRUCTORS
  78.         //
  79.         //------------------------------------------------------
  80.        
  81.         public UIPermission(PermissionState state)
  82.         {
  83.             if (state == PermissionState.Unrestricted) {
  84.                 SetUnrestricted(true);
  85.             }
  86.             else if (state == PermissionState.None) {
  87.                 SetUnrestricted(false);
  88.                 Reset();
  89.             }
  90.             else {
  91.                 throw new ArgumentException(Environment.GetResourceString("Argument_InvalidPermissionState"));
  92.             }
  93.         }
  94.        
  95.         public UIPermission(UIPermissionWindow windowFlag, UIPermissionClipboard clipboardFlag)
  96.         {
  97.             VerifyWindowFlag(windowFlag);
  98.             VerifyClipboardFlag(clipboardFlag);
  99.            
  100.             m_windowFlag = windowFlag;
  101.             m_clipboardFlag = clipboardFlag;
  102.         }
  103.        
  104.         public UIPermission(UIPermissionWindow windowFlag)
  105.         {
  106.             VerifyWindowFlag(windowFlag);
  107.            
  108.             m_windowFlag = windowFlag;
  109.         }
  110.        
  111.         public UIPermission(UIPermissionClipboard clipboardFlag)
  112.         {
  113.             VerifyClipboardFlag(clipboardFlag);
  114.            
  115.             m_clipboardFlag = clipboardFlag;
  116.         }
  117.        
  118.        
  119.         //------------------------------------------------------
  120.         //
  121.         // PUBLIC ACCESSOR METHODS
  122.         //
  123.         //------------------------------------------------------
  124.        
  125.         public UIPermissionWindow Window {
  126.            
  127.            
  128.             get { return m_windowFlag; }
  129.             set {
  130.                 VerifyWindowFlag(value);
  131.                 m_windowFlag = value;
  132.             }
  133.         }
  134.        
  135.         public UIPermissionClipboard Clipboard {
  136.            
  137.            
  138.             get { return m_clipboardFlag; }
  139.             set {
  140.                 VerifyClipboardFlag(value);
  141.                 m_clipboardFlag = value;
  142.             }
  143.         }
  144.        
  145.         //------------------------------------------------------
  146.         //
  147.         // PRIVATE AND PROTECTED HELPERS FOR ACCESSORS AND CONSTRUCTORS
  148.         //
  149.         //------------------------------------------------------
  150.        
  151.         private static void VerifyWindowFlag(UIPermissionWindow flag)
  152.         {
  153.             if (flag < UIPermissionWindow.NoWindows || flag > UIPermissionWindow.AllWindows) {
  154.                 throw new ArgumentException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Arg_EnumIllegalVal"), (int)flag));
  155.             }
  156.         }
  157.        
  158.         private static void VerifyClipboardFlag(UIPermissionClipboard flag)
  159.         {
  160.             if (flag < UIPermissionClipboard.NoClipboard || flag > UIPermissionClipboard.AllClipboard) {
  161.                 throw new ArgumentException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Arg_EnumIllegalVal"), (int)flag));
  162.             }
  163.         }
  164.        
  165.         private void Reset()
  166.         {
  167.             m_windowFlag = UIPermissionWindow.NoWindows;
  168.             m_clipboardFlag = UIPermissionClipboard.NoClipboard;
  169.         }
  170.        
  171.         private void SetUnrestricted(bool unrestricted)
  172.         {
  173.             if (unrestricted) {
  174.                 m_windowFlag = UIPermissionWindow.AllWindows;
  175.                 m_clipboardFlag = UIPermissionClipboard.AllClipboard;
  176.             }
  177.         }
  178.        
  179.        
  180.         //------------------------------------------------------
  181.         //
  182.         // CODEACCESSPERMISSION IMPLEMENTATION
  183.         //
  184.         //------------------------------------------------------
  185.        
  186.         public bool IsUnrestricted()
  187.         {
  188.             return m_windowFlag == UIPermissionWindow.AllWindows && m_clipboardFlag == UIPermissionClipboard.AllClipboard;
  189.         }
  190.        
  191.         //------------------------------------------------------
  192.         //
  193.         // IPERMISSION IMPLEMENTATION
  194.         //
  195.         //------------------------------------------------------
  196.        
  197.         public override bool IsSubsetOf(IPermission target)
  198.         {
  199.             if (target == null) {
  200.                 // Only safe subset if this is empty
  201.                 return m_windowFlag == UIPermissionWindow.NoWindows && m_clipboardFlag == UIPermissionClipboard.NoClipboard;
  202.             }
  203.            
  204.             try {
  205.                 UIPermission operand = (UIPermission)target;
  206.                 if (operand.IsUnrestricted())
  207.                     return true;
  208.                 else if (this.IsUnrestricted())
  209.                     return false;
  210.                 else
  211.                     return this.m_windowFlag <= operand.m_windowFlag && this.m_clipboardFlag <= operand.m_clipboardFlag;
  212.             }
  213.             catch (InvalidCastException) {
  214.                 throw new ArgumentException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Argument_WrongType"), this.GetType().FullName));
  215.             }
  216.            
  217.         }
  218.        
  219.         public override IPermission Intersect(IPermission target)
  220.         {
  221.             if (target == null) {
  222.                 return null;
  223.             }
  224.             else if (!VerifyType(target)) {
  225.                 throw new ArgumentException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Argument_WrongType"), this.GetType().FullName));
  226.             }
  227.            
  228.             UIPermission operand = (UIPermission)target;
  229.             UIPermissionWindow isectWindowFlags = m_windowFlag < operand.m_windowFlag ? m_windowFlag : operand.m_windowFlag;
  230.             UIPermissionClipboard isectClipboardFlags = m_clipboardFlag < operand.m_clipboardFlag ? m_clipboardFlag : operand.m_clipboardFlag;
  231.             if (isectWindowFlags == UIPermissionWindow.NoWindows && isectClipboardFlags == UIPermissionClipboard.NoClipboard)
  232.                 return null;
  233.             else
  234.                 return new UIPermission(isectWindowFlags, isectClipboardFlags);
  235.         }
  236.        
  237.         public override IPermission Union(IPermission target)
  238.         {
  239.             if (target == null) {
  240.                 return this.Copy();
  241.             }
  242.             else if (!VerifyType(target)) {
  243.                 throw new ArgumentException(String.Format(CultureInfo.CurrentCulture, Environment.GetResourceString("Argument_WrongType"), this.GetType().FullName));
  244.             }
  245.            
  246.             UIPermission operand = (UIPermission)target;
  247.             UIPermissionWindow isectWindowFlags = m_windowFlag > operand.m_windowFlag ? m_windowFlag : operand.m_windowFlag;
  248.             UIPermissionClipboard isectClipboardFlags = m_clipboardFlag > operand.m_clipboardFlag ? m_clipboardFlag : operand.m_clipboardFlag;
  249.             if (isectWindowFlags == UIPermissionWindow.NoWindows && isectClipboardFlags == UIPermissionClipboard.NoClipboard)
  250.                 return null;
  251.             else
  252.                 return new UIPermission(isectWindowFlags, isectClipboardFlags);
  253.         }
  254.        
  255.         public override IPermission Copy()
  256.         {
  257.             return new UIPermission(this.m_windowFlag, this.m_clipboardFlag);
  258.         }
  259.        
  260.        
  261.         public override SecurityElement ToXml()
  262.         {
  263.             SecurityElement esd = CodeAccessPermission.CreatePermissionElement(this, "System.Security.Permissions.UIPermission");
  264.             if (!IsUnrestricted()) {
  265.                 if (m_windowFlag != UIPermissionWindow.NoWindows) {
  266.                     esd.AddAttribute("Window", Enum.GetName(typeof(UIPermissionWindow), m_windowFlag));
  267.                 }
  268.                 if (m_clipboardFlag != UIPermissionClipboard.NoClipboard) {
  269.                     esd.AddAttribute("Clipboard", Enum.GetName(typeof(UIPermissionClipboard), m_clipboardFlag));
  270.                 }
  271.             }
  272.             else {
  273.                 esd.AddAttribute("Unrestricted", "true");
  274.             }
  275.             return esd;
  276.         }
  277.        
  278.         public override void FromXml(SecurityElement esd)
  279.         {
  280.             CodeAccessPermission.ValidateElement(esd, this);
  281.             if (XMLUtil.IsUnrestricted(esd)) {
  282.                 SetUnrestricted(true);
  283.                 return;
  284.             }
  285.            
  286.             m_windowFlag = UIPermissionWindow.NoWindows;
  287.             m_clipboardFlag = UIPermissionClipboard.NoClipboard;
  288.            
  289.             string window = esd.Attribute("Window");
  290.             if (window != null)
  291.                 m_windowFlag = (UIPermissionWindow)Enum.Parse(typeof(UIPermissionWindow), window);
  292.            
  293.             string clipboard = esd.Attribute("Clipboard");
  294.             if (clipboard != null)
  295.                 m_clipboardFlag = (UIPermissionClipboard)Enum.Parse(typeof(UIPermissionClipboard), clipboard);
  296.         }
  297.        
  298.         /// <internalonly/>
  299.         int IBuiltInPermission.GetTokenIndex()
  300.         {
  301.             return UIPermission.GetTokenIndex();
  302.         }
  303.        
  304.         static internal int GetTokenIndex()
  305.         {
  306.             return BuiltInPermissionIndex.UIPermissionIndex;
  307.         }
  308.        
  309.     }
  310.    
  311.    
  312. }

Developer Fusion