大网数据广告活动
.NET 与 C# 开发

使用 Assert 方法

· 52CE 我爱测

是一种可在代码访问权限类和 类上调用的方法。 可以使用Assert以使你的代码 (和下游调用方) 可以执行你的代码有权执行的操作,但其调用方可能没有执行操作的权限。 安全断言会更改在安全检查期间运行时所执行的正常过程。 断言权限时,它会通知安全系统不检查断言权限的代码的调用方。

Caution: 代码访问安全性和部分受信任的代码

.NET Framework 提供一种机制,对在相同应用程序中运行的不同代码强制实施不同的信任级别,该机制称为代码访问安全性 (CAS)。 .NET Framework 中的代码访问安全性不应用作基于代码来源或其他标识方面强制实施安全边界的一种机制。 我们正在更新相应指南以反映代码访问安全性,并且将不支持把安全透明代码用作部分受信任的代码(尤其是未知来源的代码)的安全边界。 建议在未实施其他安全措施的情况下,不要加载和执行未知来源的代码。

此策略适用于 .NET Framework 的所有版本,但不适用于 Silverlight 中所含的 .NET Framework。

xref:System.Security.CodeAccessPermission.Assert* 是一种可在代码访问权限类和 xref:System.Security.PermissionSet 类上调用的方法。 可以使用Assert以使你的代码 (和下游调用方) 可以执行你的代码有权执行的操作,但其调用方可能没有执行操作的权限。 安全断言会更改在安全检查期间运行时所执行的正常过程。 断言权限时,它会通知安全系统不检查断言权限的代码的调用方。

Caution: 请谨慎使用断言,因为它们会打开安全漏洞并破坏运行时强制执行安全限制的机制。

当库调用非托管代码或所执行的调用需要与库的预期用途不明显关联的权限时,断言非常有用。 例如,所有托管代码调用到非托管代码必须具有SecurityPermission与UnmanagedCode指定标志。 默认情况下,如果代码不是来自本地计算机(如从本地 intranet 下载的代码),则不会对其授予此权限。 因此,为了使从本地 intranet 下载的代码能调用使用非托管代码的库,它必须具有由该库断言的权限。 此外,某些库可能会执行对调用方不可见且需要特殊权限的调用。

在代码以对调用方完全不可见的方式访问资源时,也可使用断言。 例如,假设你的库从数据库获取信息,但在此过程中还会从计算机注册表读取信息。 使用你的库的开发人员无权访问你的源,因为它们有没有办法知道其代码需要RegistryPermission若要使用你的代码。 在此情况下,如果你决定要求代码调用方有权访问注册表是不合理或不必要的,你可以断言权限以读取注册表。 在这种情况下,它是库可以断言权限以使相应的无需该调用方RegistryPermission可以使用库。

仅当断言权限和下游调用方所需的权限属于同一类型且要求的权限是断言权限的子集时,断言才会影响堆栈审核。 例如,如果你断言FileIOPermission读取 C 驱动器,和的下游要求的所有文件以供FileIOPermission读取 C:\Temp 中的文件,则断言可能会影响堆栈审核;但是,如果是要求FileIOPermission要写入到 C 驱动器,则断言会产生任何影响。

若要执行断言,必须向你的代码授予正在断言的权限以及表示有权执行断言的 xref:System.Security.Permissions.SecurityPermission。 虽然你可以断言尚未授予代码的权限,但此断言毫无意义,因为安全检查在断言使其成功之前就会失败。

下图显示了在使用时,会发生什么情况Assert。 假设以下语句针对程序集 A、B、C、E 和 F 以及 P1 和 P1A 两个权限为 true:

  • P1A 表示读取 C 驱动器上的 .txt 文件的权限。

  • P1 表示读取 C 驱动器上所有文件的权限。

  • P1A 和 P1 都FileIOPermission类型,且 P1A 是 P1 的子集。

  • 已向程序集 E 和 F 授予了 P1A 权限。

  • 已向程序集 C 授予了 P1 权限。

  • 尚未向程序集 A 和 B 授予 P1 或 P1A 权限。

  • 方法 A 包含在程序集 A 中,方法 B 包含在程序集 B 中,依次类推。

显示断言方法程序集的关系图。

在此方案中,方法 A 调用 B,B 调用 C、 C 调用 E、 E 调用 f。 方法 C 断言权限来读取 C 驱动器 (权限 P1) 上的文件,方法 E 要求权限以读取 C 驱动器 (权限 P1A) 上的.txt 文件。 当在运行时遇到 F 中的要求时,执行堆栈审核检查 F 的所有调用方的权限从 E 开始已授予 P1A 权限,因此堆栈遍历继续探讨的 C,其中发现 C 的断言的权限。 因为要求的权限 (P1A) 是断言的权限 (P1) 的子集,所以堆栈审核将停止且安全检查会自动成功。 未向程序集 A 和 B 授予权限 P1A 并不重要。 通过断言 P1,方法 C 确保其调用方可以访问受 P1 保护的资源,即使尚未授予调用方访问该资源的权限也是如此。

如果你设计一个类库且某个类访问受保护的资源,则在大多数情况下,你应该提出安全要求,要求此类的调用方拥有适当的权限。 如果该类随后会执行的操作知道其大多数调用方均方没有相应权限,并且如果您愿意承担责任让这些调用方调用你的代码,你可以断言权限,通过调用Assert表示的操作的权限对象上的方法的代码是否执行。 使用Assert允许调用方,因此通常不能以这种方式调用你的代码。 因此,如果你断言了一个权限,应确保预先执行了适当的安全检查,以防止你的组件被误用。

例如,假设你的高度受信任的库类具有删除文件的方法。 它通过调用非托管的 Win32 函数来访问文件。 调用方调用你的代码删除方法,传递要删除的文件的名称 C:\Test.txt。 内删除方法时,你的代码创建xref:System.Security.Permissions.FileIOPermission对象,表示对 C:\Test.txt 的写访问权限。 (需要写权限来删除文件。)你的代码然后调用命令性安全检查通过调用FileIOPermission对象的需方法。 如果调用堆栈中的某个调用方不具有此权限,则会引发 xref:System.Security.SecurityException。 如果未引发任何异常,你会知道所有调用方都有权限访问 C:\Test.txt。 由于您确信大多数调用方没有权限访问非托管的代码,然后创建你的代码xref:System.Security.Permissions.SecurityPermission对象,表示有权调用非托管的代码并调用该对象的Assert方法。 最后,它会调用非托管的 Win32 函数来删除 C:\Text.txt,并将控件返回给调用方。

Caution: 你必须确保你的代码在以下情况下不使用断言:其他代码可使用你的代码来访问由你正在断言的权限所保护的资源。 例如,在代码中,将写入到其名称由作为参数调用方指定的文件,您将不声明FileIOPermission来写入文件,因为你的代码都是由第三方误用。

当使用命令性安全语法时,调用Assert对同一方法中的多个权限的方法将导致引发安全异常。 相反,应创建PermissionSet对象,将其传递要调用,然后调用的各个权限Assert方法PermissionSet对象。 您可以调用Assert比一次使用声明性安全语法更多的方法。

下面的示例演示声明性语法来重写安全检查使用的Assert方法。 请注意, FileIOPermissionAttribute语法采用两个值:xref:System.Security.Permissions.SecurityAction枚举与文件或目录的权限是要对其授予的位置。 在调用Assert导致各要求访问C:\Log.txt成功,即使调用方未检查的权限访问该文件。

Option Explicit  
Option Strict  
  
Imports System  
Imports System.IO  
Imports System.Security.Permissions  
  
Namespace LogUtil  
   Public Class Log  
      Public Sub New()  
  
      End Sub  
  
     <FileIOPermission(SecurityAction.Assert, All := "C:\Log.txt")> Public Sub   
      MakeLog()  
         Dim TextStream As New StreamWriter("C:\Log.txt")  
         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now) '  
         TextStream.Close()  
      End Sub  
   End Class  
End Namespace  
namespace LogUtil  
{  
   using System;  
   using System.IO;  
   using System.Security.Permissions;  
  
   public class Log  
   {  
      public Log()  
      {      
      }     
      [FileIOPermission(SecurityAction.Assert, All = @"C:\Log.txt")]  
      public void MakeLog()  
      {     
         StreamWriter TextStream = new StreamWriter(@"C:\Log.txt");  
         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now);  
         TextStream.Close();  
      }  
   }  
}   

以下代码片段显示重写安全检查使用命令性语法Assert方法。 在此示例中,实例FileIOPermission声明对象。 其构造函数传递FileIOPermissionAccess.AllAccess以定义的允许,访问类型后, 跟描述文件的位置的字符串。 一次FileIOPermission定义对象,只需调用其Assert方法重写安全检查。

Option Explicit  
Option Strict  
Imports System  
Imports System.IO  
Imports System.Security.Permissions  
Namespace LogUtil  
   Public Class Log  
      Public Sub New()  
      End Sub 'New  
  
      Public Sub MakeLog()  
         Dim FilePermission As New FileIOPermission(FileIOPermissionAccess.AllAccess, "C:\Log.txt")  
         FilePermission.Assert()  
         Dim TextStream As New StreamWriter("C:\Log.txt")  
         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now)  
         TextStream.Close()  
      End Sub  
   End Class  
End Namespace  
namespace LogUtil  
{  
   using System;  
   using System.IO;  
   using System.Security.Permissions;  
  
   public class Log  
   {  
      public Log()  
      {      
      }     
      public void MakeLog()  
      {  
         FileIOPermission FilePermission = new FileIOPermission(FileIOPermissionAccess.AllAccess,@"C:\Log.txt");   
         FilePermission.Assert();  
         StreamWriter TextStream = new StreamWriter(@"C:\Log.txt");  
         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now);  
         TextStream.Close();  
      }  
   }  
}  

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。