WebPermission Classe

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll

Controla os direitos de acesso a recursos HTTP da Internet.

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
Herança
Object
CodeAccessPermission
WebPermission
Atributos
SerializableAttribute
Implementações
IUnrestrictedPermission

Observações

Atenção

O CAS (Code Access Security) foi preterido em todas as versões do .NET Framework e do .NET. As versões recentes do .NET não respeitam as anotações do CAS e produzem erros se as APIs relacionadas ao CAS forem usadas. Os desenvolvedores devem procurar meios alternativos de realizar tarefas de segurança.

WebPermission fornece um conjunto de métodos e propriedades para controlar o acesso a recursos da Internet. Pode usar a WebPermission para fornecer acesso restrito ou irrestrito ao seu recurso, com base no PermissionState que está definido quando o WebPermission recurso é criado.

Crie uma WebPermission instância chamando o seu construtor usando um dos seguintes conjuntos de parâmetros:

O ConnectList e AcceptList mantém os URIs aos quais concedeu permissão de acesso. Para adicionar um URI a qualquer uma destas listas, use AddPermission. Se passar Accept como o NetworkAccess parâmetro, o URI será adicionado ao AcceptList. WebPermission permitirá ligações à sua classe alvo com URIs correspondentes ao AcceptList.

Atenção

Para negar o acesso a um recurso da Internet, deve negar o acesso a todos os caminhos possíveis para esse recurso. Isto requer chamar WebPermission.WebPermission com o parâmetro de estado definido em Deny. Uma abordagem melhor é permitir o acesso apenas ao recurso específico. Para mais informações sobre este assunto, consulte o tópico Usar o Método de Negar .

Note

Tens de negar o acesso usando apenas o caminho canónico do recurso. Não é necessário usar todas as variações sintáticas do caminho.

Note

O nome de utilizador e a informação de porta padrão são removidos do Uri argumento de expressão regular fornecido ao WebPermission(NetworkAccess, Regex) construtor antes da comparação. Se a expressão regular contiver informação do utilizador ou o número de porta padrão, então todos os s recebidos Urifalharão em corresponder à expressão regular.

Construtores

Name Description
WebPermission()

Cria uma nova instância da WebPermission classe.
WebPermission(NetworkAccess, Regex)

Inicializa uma nova instância da WebPermission classe com os direitos de acesso especificados para a expressão regular do URI especificada.
WebPermission(NetworkAccess, String)

Inicializa uma nova instância da WebPermission classe com os direitos de acesso especificados para o URI especificado.
WebPermission(PermissionState)

Cria uma nova instância da WebPermission classe que passa em todas as exigências ou falha em todas as exigências.

Propriedades

Name Description
AcceptList

Esta propriedade devolve uma enumeração de uma única aceitação de permissões detidas por este WebPermission. Os tipos de objetos possíveis contidos na enumeração devolvida são String e Regex.
ConnectList

Esta propriedade devolve uma enumeração de uma única permissão de ligação detida por este WebPermission. Os tipos de objetos possíveis contidos na enumeração devolvida são String e Regex.

Métodos

Name Description
AddPermission(NetworkAccess, Regex)

Adiciona o URI especificado com os direitos de acesso especificados ao atual WebPermission.
AddPermission(NetworkAccess, String)

Adiciona a cadeia de URI especificada com os direitos de acesso especificados ao atual WebPermission.
Assert()

Declara que o código de chamada pode aceder ao recurso protegido por uma exigência de permissão através do código que chama este método, mesmo que os chamadores mais acima na pilha não tenham recebido permissão para aceder ao recurso. Usar Assert() pode criar problemas de segurança.

(Herdado de CodeAccessPermission)
Copy()

Cria uma cópia de um WebPermission.
Demand()

Força a SecurityException em tempo de execução se todos os chamadores superiores na pilha de chamadas não tiverem recebido a permissão especificada pela instância atual.

(Herdado de CodeAccessPermission)
Deny()
Obsoleto.

Impede que os chamadores mais acima na pilha de chamadas usem o código que chama este método para aceder ao recurso especificado pela instância atual.

(Herdado de CodeAccessPermission)
Equals(Object)

Determina se o objeto especificado CodeAccessPermission é igual à corrente CodeAccessPermission.

(Herdado de CodeAccessPermission)
FromXml(SecurityElement)

Reconstrói a WebPermission a partir de uma codificação XML.
GetHashCode()

Obtém um código hash para o CodeAccessPermission objeto adequado para uso em algoritmos de hash e estruturas de dados, como uma tabela hash.

(Herdado de CodeAccessPermission)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Intersect(IPermission)

Devolve a interseção lógica de duas WebPermission instâncias.
IsSubsetOf(IPermission)

Determina se a corrente WebPermission é um subconjunto do objeto especificado.
IsUnrestricted()

Verifica o estado geral de permissão do WebPermission.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
PermitOnly()

Impede que os chamadores mais acima na pilha de chamadas usem o código que chama este método para aceder a todos os recursos, exceto ao recurso especificado pela instância atual.

(Herdado de CodeAccessPermission)
ToString()

Cria e devolve uma representação em cadeia do objeto de permissão atual.

(Herdado de CodeAccessPermission)
ToXml()

Cria uma codificação XML de a WebPermission e do seu estado atual.
Union(IPermission)

Devolve a união lógica entre duas instâncias da WebPermission classe.

Aplica-se a

Ver também