WebPermission Класс

Определение

Пространство имен:

System.Net

Сборка:

System.dll

Управляет правами доступа к ресурсам HTTP в Интернете.

public ref class WebPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission

[System.Serializable]
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[<System.Serializable>]
type WebPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class WebPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

Наследование

Object

CodeAccessPermission

WebPermission

Атрибуты

SerializableAttribute

Реализации

IUnrestrictedPermission

Комментарии

Предостережение

Безопасность доступа к коду (CAS) устарела во всех версиях платформ .NET Framework, и .NET. Последние версии .NET не учитывают заметки CAS и создают ошибки, если используются API, связанные с CAS. Разработчики должны искать альтернативные средства выполнения задач безопасности.

WebPermission предоставляет набор методов и свойств для управления доступом к интернет-ресурсам. Можно использовать WebPermission для предоставления ограниченного или неограниченного доступа к ресурсу на основе заданного PermissionState при WebPermission создании.

WebPermission Создайте экземпляр, вызвав его конструктор с помощью одного из следующих наборов параметров:

• Без параметров. По умолчанию PermissionState является None.

• А PermissionState. Unrestricted Укажите любой URI, используемый в целевом классе, или None разрешить доступ только к URI, заданным с помощью AddPermission метода.

• NetworkAccess Значение и строка URI. Указанный универсальный код ресурса (URI) имеет разрешения, предоставленные значением NetworkAccess .

• Описатель и регулярное NetworkAccess выражение URI.

ConnectList И AcceptList удерживайте URI, к которым вы предоставили разрешение на доступ. Чтобы добавить универсальный код ресурса (URI) в любой из этих списков, используйте AddPermission. Если вы передаете AcceptNetworkAccess в качестве параметра, URI будет добавлен в этот AcceptListпараметр. WebPermission позволит подключениям к целевому классу с URI, соответствующими AcceptList.

Предостережение

Чтобы запретить доступ к интернет-ресурсу, необходимо запретить доступ ко всем возможным путям к нему. Для этого требуется вызов WebPermission.WebPermission с заданным параметром Denyсостояния. Лучший подход — разрешить доступ только к конкретному ресурсу. Дополнительные сведения об этой теме см. в разделе "Использование метода запрета ".

Note

Необходимо запретить доступ, используя только канонический путь к ресурсу. Нет необходимости использовать все синтаксические вариации пути.

Note

Имя пользователя и сведения о порту по умолчанию отрезаются от Uri сравнения с аргументом регулярного выражения, предоставленным конструктору WebPermission(NetworkAccess, Regex) . Если регулярное выражение содержит сведения о пользователе или номер порта по умолчанию, все входящие Uris не будут соответствовать регулярному выражению.

Конструкторы

Имя	Описание
WebPermission()	Создает новый экземпляр класса WebPermission.
WebPermission(NetworkAccess, Regex)	Инициализирует новый экземпляр WebPermission класса с указанными правами доступа для указанного регулярного выражения URI.
WebPermission(NetworkAccess, String)	Инициализирует новый экземпляр WebPermission класса с указанными правами доступа для указанного URI.
WebPermission(PermissionState)	Создает новый экземпляр WebPermission класса, который передает все требования или завершается сбоем всех требований.

Свойства

Имя	Описание
AcceptList	Это свойство возвращает перечисление одного разрешения, удерживаемого этим WebPermission. Возможные типы объектов, содержащиеся в возвращаемом перечислении, и StringRegex.
ConnectList	Это свойство возвращает перечисление одного разрешения подключения, удерживаемого этим WebPermissionсвойством. Возможные типы объектов, содержащиеся в возвращаемом перечислении, и StringRegex.

Методы

Имя	Описание
AddPermission(NetworkAccess, Regex)	Добавляет указанный универсальный код ресурса (URI) с указанными правами доступа к текущему WebPermission.
AddPermission(NetworkAccess, String)	Добавляет указанную строку URI с указанными правами доступа к текущему WebPermission.
Assert()	Объявляет, что вызывающий код может получить доступ к ресурсу, защищенному запросом разрешений, с помощью кода, вызывающего этот метод, даже если вызывающие элементы в стеке не были предоставлены разрешения на доступ к ресурсу. Использование Assert() может создавать проблемы безопасности. (Унаследовано от CodeAccessPermission)
Copy()	Создает копию WebPermission.
Demand()	SecurityException Принудительно выполняется, если все вызывающие объекты в стеке вызовов не были предоставлены разрешения, указанные текущим экземпляром. (Унаследовано от CodeAccessPermission)
Deny()	Устаревшие.. Запрещает вызывающим объектам в стеке вызовов использовать код, который вызывает этот метод для доступа к ресурсу, указанному текущим экземпляром. (Унаследовано от CodeAccessPermission)
Equals(Object)	Определяет, равен ли указанный CodeAccessPermission объект текущему CodeAccessPermissionобъекту. (Унаследовано от CodeAccessPermission)
FromXml(SecurityElement)	WebPermission Восстанавливает кодирование из XML-кода.
GetHashCode()	Получает хэш-код для объекта, который подходит для CodeAccessPermission использования в хэш-алгоритмах и структурах данных, таких как хэш-таблица. (Унаследовано от CodeAccessPermission)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Intersect(IPermission)	Возвращает логическое пересечение двух WebPermission экземпляров.
IsSubsetOf(IPermission)	Определяет, является ли текущий WebPermission подмножеством указанного объекта.
IsUnrestricted()	Проверяет общее состояние WebPermissionразрешений объекта .
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
PermitOnly()	Запрещает вызывающим объектам в стеке вызовов использовать код, который вызывает этот метод для доступа ко всем ресурсам, кроме ресурса, указанного текущим экземпляром. (Унаследовано от CodeAccessPermission)
ToString()	Создает и возвращает строковое представление текущего объекта разрешений. (Унаследовано от CodeAccessPermission)
ToXml()	Создает xml-кодировку текущего WebPermission состояния и ее состояния.
Union(IPermission)	Возвращает логический союз между двумя экземплярами WebPermission класса.

См. также раздел

• CodeAccessPermission
• PermissionState
• NetworkAccess