UrlIdentityPermission 类

定义

注意

Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}

为代码的来源 URL 定义标识权限。Defines the identity permission for the URL from which the code originates. 此类不能被继承。This class cannot be inherited.

public ref class UrlIdentityPermission sealed : System::Security::CodeAccessPermission
public sealed class UrlIdentityPermission : System.Security.CodeAccessPermission
[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class UrlIdentityPermission : System.Security.CodeAccessPermission
[System.Serializable]
public sealed class UrlIdentityPermission : System.Security.CodeAccessPermission
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class UrlIdentityPermission : System.Security.CodeAccessPermission
type UrlIdentityPermission = class
    inherit CodeAccessPermission
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type UrlIdentityPermission = class
    inherit CodeAccessPermission
[<System.Serializable>]
type UrlIdentityPermission = class
    inherit CodeAccessPermission
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UrlIdentityPermission = class
    inherit CodeAccessPermission
Public NotInheritable Class UrlIdentityPermission
Inherits CodeAccessPermission
继承
UrlIdentityPermission
属性

注解

将考虑完整的 URL,包括 (HTTP、HTTPS、FTP) 和文件的协议。The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file. 例如, http://www.fourthcoffee.com/process/grind.htm 是一个完整的 URL。For example, http://www.fourthcoffee.com/process/grind.htm is a complete URL.

Url 可以完全与最终位置中的通配符匹配,例如: http://www.fourthcoffee.com/process/*URLs can be matched exactly or by a wildcard in the final position, for example: http://www.fourthcoffee.com/process/*. Url 还可以 * 在点分隔符上包含通配符 ( "" ) 前缀。URLs can also contain a wildcard ("*") prefix at the dot delimiter. 例如,URL 名称字符串 http://www.fourthcoffee.com/process/grind.htm/ 是和的子集 http://*.fourthcoffee.com/process/grind.htm/ http://*.com/process/grind.htm/For example, the URL name string http://www.fourthcoffee.com/process/grind.htm/ is a subset of http://*.fourthcoffee.com/process/grind.htm/ and http://*.com/process/grind.htm/.

重要

从开始 .NET Framework 4.NET Framework 4 ,不使用标识权限。Starting with the .NET Framework 4.NET Framework 4, identity permissions are not used.

在 .NET Framework 版本1.0 和1.1 中,即使调用程序集是完全受信任的,对标识权限的要求仍有效。In the .NET Framework versions 1.0 and 1.1, demands on the identity permissions are effective even when the calling assembly is fully trusted. 也就是说,尽管调用程序集具有完全信任,但如果程序集不满足要求的条件,则标识权限的请求会失败。That is, although the calling assembly has full trust, a demand for an identity permission fails if the assembly does not meet the demanded criteria. 从 .NET Framework 版本2.0 开始,如果调用程序集具有完全信任,则标识权限要求将无效。Starting with the .NET Framework version 2.0, demands for identity permissions are ineffective if the calling assembly has full trust. 也就是说,如果程序集已被授予完全信任,则标识的请求始终会成功,无论程序集的标识如何都是如此。That is, a demand for an identity always succeeds, regardless of the identity of the assembly, if the assembly has been granted full trust. 这将确保所有权限的一致性,从而不会将标识权限视为一种特殊情况。This assures consistency for all permissions, eliminating the treatment of identity permissions as a special case.

备注

在之前 .NET Framework 版本中 .NET Framework 4.NET Framework 4 ,你可以使用 CodeAccessPermission.Deny 方法来防止无意中通过受信任代码访问系统资源。In versions of the .NET Framework before the .NET Framework 4.NET Framework 4, you could use the CodeAccessPermission.Deny method to prevent inadvertent access to system resources by trusted code. Deny 现已过时,并且现在仅由为程序集授予的权限集确定对资源的访问权限。Deny is now obsolete, and access to resources is now determined solely by the granted permission set for an assembly. 若要限制对文件的访问,必须在沙盒中运行部分受信任的代码,并仅向该代码允许访问的资源分配权限。To limit access to files, you must run partially trusted code in a sandbox and assign it permissions only to resources that the code is allowed to access. 有关在沙盒中运行应用程序的信息,请参阅 如何:在沙盒中运行部分受信任的代码For information about running an application in a sandbox, see How to: Run Partially Trusted Code in a Sandbox.

备注

在 .NET Framework 版本1.0 和1.1 中,标识权限不能具有 Unrestricted 权限状态值。In the .NET Framework versions 1.0 and 1.1, identity permissions cannot have an Unrestricted permission state value. 从 .NET Framework 版本2.0 开始,标识权限可以具有任何权限状态值。Starting with the .NET Framework version 2.0, identity permissions can have any permission state value. 这意味着在2.0 及更高版本中,标识权限与实现该接口的权限具有相同的行为 IUnrestrictedPermissionThis means that in 2.0 and later versions, identity permissions have the same behavior as permissions that implement the IUnrestrictedPermission interface.

构造函数

UrlIdentityPermission(PermissionState)

使用指定的 UrlIdentityPermission 初始化 PermissionState 类的新实例。Initializes a new instance of the UrlIdentityPermission class with the specified PermissionState.

UrlIdentityPermission(String)

初始化 UrlIdentityPermission 类的新实例,以表示 site 所描述的 URL 标识。Initializes a new instance of the UrlIdentityPermission class to represent the URL identity described by site.

属性

Url

获取或设置表示 Internet 代码的标识的 URL。Gets or sets a URL representing the identity of Internet code.

方法

Assert()

声明调用代码能够通过调用此方法的代码,访问受权限请求保护的资源,即使未对堆栈中处于较高位置的调用方授予访问该资源的权限。Declares that the calling code can access the resource protected by a permission demand through the code that calls this method, even if callers higher in the stack have not been granted permission to access the resource. 使用 Assert() 会引起安全问题。Using Assert() can create security issues.

(继承自 CodeAccessPermission)
Copy()

创建并返回当前权限的相同副本。Creates and returns an identical copy of the current permission.

Demand()

如果未对调用堆栈中处于较高位置的所有调用方授予当前实例所指定的权限,则在运行时强制 SecurityExceptionForces a SecurityException at run time if all callers higher in the call stack have not been granted the permission specified by the current instance.

(继承自 CodeAccessPermission)
Deny()
已过时。
已过时。

防止处于调用堆栈较高位置的调用函数使用可以调用此方法来访问当前实例指定资源的代码。Prevents callers higher in the call stack from using the code that calls this method to access the resource specified by the current instance.

(继承自 CodeAccessPermission)
Equals(Object)

确定指定的 CodeAccessPermission 对象是否等于当前的 CodeAccessPermissionDetermines whether the specified CodeAccessPermission object is equal to the current CodeAccessPermission.

(继承自 CodeAccessPermission)
FromXml(SecurityElement)

从 XML 编码重新构造具有指定状态的权限。Reconstructs a permission with a specified state from an XML encoding.

GetHashCode()

获取 CodeAccessPermission 对象的哈希代码,此代码适合在哈希算法和数据结构(例如哈希表)中使用。Gets a hash code for the CodeAccessPermission object that is suitable for use in hashing algorithms and data structures such as a hash table.

(继承自 CodeAccessPermission)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
Intersect(IPermission)

创建并返回一个权限,该权限是当前权限与指定权限的交集。Creates and returns a permission that is the intersection of the current permission and the specified permission.

IsSubsetOf(IPermission)

确定当前权限是否为指定权限的子集。Determines whether the current permission is a subset of the specified permission.

MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
PermitOnly()

防止处于调用堆栈较高位置的调用函数使用此代码,此代码将调用此方法来访问除当前实例指定的资源以外的所有资源。Prevents callers higher in the call stack from using the code that calls this method to access all resources except for the resource specified by the current instance.

(继承自 CodeAccessPermission)
ToString()

创建并返回当前权限对象的字符串表示形式。Creates and returns a string representation of the current permission object.

(继承自 CodeAccessPermission)
ToXml()

创建权限及其当前状态的 XML 编码。Creates an XML encoding of the permission and its current state.

Union(IPermission)

创建一个权限,该权限是当前权限与指定权限的并集。Creates a permission that is the union of the current permission and the specified permission.

显式接口实现

IPermission.Demand()

如果不满足安全要求,则会在运行时引发 SecurityExceptionThrows a SecurityException at run time if the security requirement is not met.

(继承自 CodeAccessPermission)
IStackWalk.Assert()

断言调用代码可以访问当前权限对象所标识的资源,即使尚未对堆栈中的高级调用方授予访问该资源的权限。Asserts that the calling code can access the resource identified by the current permission object, even if callers higher in the stack have not been granted permission to access the resource.

(继承自 CodeAccessPermission)
IStackWalk.Demand()

在运行时确定调用堆栈中的所有调用方是否已被授予当前权限对象所指定的权限。Determines at run time whether all callers in the call stack have been granted the permission specified by the current permission object.

(继承自 CodeAccessPermission)
IStackWalk.Deny()

将导致通过调用代码传递的当前对象的每个 Demand() 失败。Causes every Demand() for the current object that passes through the calling code to fail.

(继承自 CodeAccessPermission)
IStackWalk.PermitOnly()

导致所有对象的每个 Demand()(除了通过调用代码的当前那个)失败,即使调用堆栈中较高级别的代码已被授予访问其他资源的权限也是如此。Causes every Demand() for all objects except the current one that pass through the calling code to fail, even if code higher in the call stack has been granted permission to access other resources.

(继承自 CodeAccessPermission)

适用于

另请参阅