WebPermission Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Controla os direitos de acesso aos recursos da Internet 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
- Herança
- Atributos
- Implementações
Comentários
Caution
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 honram as anotações CAS e geram erros se as APIs relacionadas ao CAS forem usadas. Os desenvolvedores devem buscar meios alternativos para realizar tarefas de segurança.
WebPermission fornece um conjunto de métodos e propriedades para controlar o acesso aos recursos da Internet. Você pode usar um WebPermission para fornecer acesso restrito ou irrestrito ao seu recurso, com base no PermissionState que é definido quando ele WebPermission é criado.
Crie uma WebPermission instância chamando seu construtor usando um dos seguintes conjuntos de parâmetros:
Sem parâmetros. O valor padrão PermissionState é None.
Um PermissionState. Especifique para Unrestricted permitir que qualquer URI seja usado na classe de destino ou None para permitir o acesso somente a URIs que você especificar por meio do uso do AddPermission método.
Um NetworkAccess valor e uma cadeia de caracteres de URI. O URI especificado tem permissões concedidas pelo NetworkAccess valor.
Um NetworkAccess especificador e uma expressão regular de URI.
ConnectList E AcceptList mantenha pressionadas as URIs às quais você concedeu permissão de acesso. Para adicionar um URI a qualquer uma dessas listas, use AddPermission. Se você passar Accept como o NetworkAccess parâmetro, o URI será adicionado ao AcceptList. WebPermission permitirá conexões com sua classe de destino com URIs correspondentes a AcceptList.
Caution
Para negar o acesso a um recurso da Internet, você deve negar o acesso a todos os caminhos possíveis para esse recurso. Isso requer a chamada WebPermission.WebPermission com o parâmetro de estado definido como Deny. Uma abordagem melhor é permitir o acesso somente ao recurso específico. Para obter mais informações sobre esse assunto, consulte o tópico Usando o Método Deny .
Note
Você precisa 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 usuário e as Uri informações de porta padrão são removidos da comparação anterior com o argumento de expressão regular fornecido ao WebPermission(NetworkAccess, Regex) construtor. Se a expressão regular contiver informações do usuário ou o número de porta padrão, todas as entradas Urinão corresponderão à expressão regular.
Construtores
| Nome | 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 de 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 todas as demandas ou falha em todas as demandas. |
Propriedades
| Nome | Description |
|---|---|
| AcceptList |
Essa propriedade retorna uma enumeração de permissões de aceitação única mantidas por essa WebPermissionpropriedade. Os tipos de objetos possíveis contidos na enumeração retornada são String e Regex. |
| ConnectList |
Essa propriedade retorna uma enumeração de uma única permissão de conexão mantida por essa WebPermission. Os tipos de objetos possíveis contidos na enumeração retornada são String e Regex. |
Métodos
| Nome | Description |
|---|---|
| AddPermission(NetworkAccess, Regex) |
Adiciona o URI especificado com os direitos de acesso especificados ao atual WebPermission. |
| AddPermission(NetworkAccess, String) |
Adiciona a cadeia de caracteres de URI especificada com os direitos de acesso especificados ao atual WebPermission. |
| Assert() |
Declara que o código de chamada pode acessar o recurso protegido por uma demanda de permissão por meio do código que chama esse método, mesmo que os chamadores mais altos na pilha não tenham recebido permissão para acessar o recurso. O uso Assert() pode criar problemas de segurança. (Herdado de CodeAccessPermission) |
| Copy() |
Cria uma cópia de um WebPermission. |
| Demand() |
Força um SecurityException tempo de execução se todos os chamadores mais altos 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 altos na pilha de chamadas usem o código que chama esse método para acessar o recurso especificado pela instância atual. (Herdado de CodeAccessPermission) |
| Equals(Object) |
Determina se o objeto especificado CodeAccessPermission é igual ao atual CodeAccessPermission. (Herdado de CodeAccessPermission) |
| FromXml(SecurityElement) |
Reconstrói um de WebPermission 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 de hash. (Herdado de CodeAccessPermission) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Intersect(IPermission) |
Retorna 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 de permissão geral do WebPermission. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| PermitOnly() |
Impede que os chamadores mais altos na pilha de chamadas usem o código que chama esse método para acessar todos os recursos, exceto o recurso especificado pela instância atual. (Herdado de CodeAccessPermission) |
| ToString() |
Cria e retorna uma representação de cadeia de caracteres do objeto de permissão atual. (Herdado de CodeAccessPermission) |
| ToXml() |
Cria uma codificação XML de um WebPermission e seu estado atual. |
| Union(IPermission) |
Retorna a união lógica entre duas instâncias da WebPermission classe. |