Permission 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.
Fornece acesso às UserPermissionCollection configurações de permissão e que podem ser aplicadas a um formulário.
public ref class Permission abstract
public abstract class Permission
type Permission = class
Public MustInherit Class Permission
- Herança
-
Permission
Comentários
Use a classe Permissão e seus membros para restringir permissões ao formulário ativo e para obter ou definir configurações de permissões específicas.
Uma instância da classe Permission associada a um modelo de formulário é retornada pela Microsoft.Office.InfoPath.Xmlform.Permission propriedade da XmlForm classe. O objeto Permission retornado fornece acesso à coleção de UserPermission objetos associados ao modelo de formulário e a cada instância de formulário criada com esse modelo. Cada objeto UserPermission é usado para definir um conjunto específico de direitos para um usuário individual. Embora algumas permissões concedidas por meio da interface do usuário se apliquem a todos os usuários, você pode usar o objeto UserPermission para atribuir permissão por usuário com datas de validade por usuário.
O objeto Permission e suas propriedades e métodos estão disponíveis se as permissões são restritas no modelo de formulário ativo ou não. Use a Enabled propriedade para determinar se um formulário tem permissões restritas.
Se o cliente do Windows Rights Management não estiver instalado no computador de um usuário, usar a classe Permissão gerará uma exceção.
As permissões em um formulário são habilitadas de uma das seguintes maneiras usando propriedades e métodos da classe Permissão :
A propriedade Habilitada é definida como true.
A DocumentAuthor propriedade está definida.
A RequestPermissionUrl propriedade está definida.
A StoreLicenses propriedade é definida como true ou false.
O ApplyPolicy(String) método é chamado.
As permissões em um formulário também podem ser habilitadas usando um dos Add(String) métodos da classe UserPermissionCollection para adicionar um usuário à coleção de permissões de usuário do formulário.
Observação: as permissões não podem ser aplicadas quando um formulário está no modo de visualização. Por esse motivo, todas as propriedades da classe Permission são somente leitura quando um formulário está sendo visualizado. No modo de visualização, a propriedade Habilitada sempre retornará false e, se o código tentar alterar essa configuração, um System.Runtime.InteropServices.COMException será gerado e o erro "A propriedade/método não está disponível no modo de visualização" será retornado. Da mesma forma, as propriedades e os métodos associados às classes UserPermission e UserPermissionCollection também retornarão essa mensagem de erro quando usadas no modo de visualização.
Construtores
Permission() |
Fornece acesso às UserPermissionCollection configurações de permissão e que podem ser aplicadas a um formulário. |
Propriedades
DocumentAuthor |
Obtém ou define o autor do formulário atual como um endereço de email. |
Enabled |
Obtém ou define se as configurações de permissão representadas pelo objeto Permission estão habilitadas para o formulário atual. |
PermissionFromPolicy |
Obtém se uma política de permissão foi aplicada ao formulário atual. |
PolicyDescription |
Obtém uma descrição da política que foi aplicada ao formulário atual. |
PolicyName |
Obtém o nome da política que foi aplicada ao formulário atual. |
RequestPermissionUrl |
Obtém ou define o arquivo, URL ou endereço de email para entrar em contato com usuários que precisam de permissões adicionais no formulário atual. |
StoreLicenses |
Obtém ou define se a licença do usuário para exibir o formulário atual deve ser armazenada em cache para permitir a exibição offline quando o usuário não puder se conectar a um servidor de gerenciamento de direitos. |
UserPermissions |
Obtém um UserPermissionCollection para o formulário atual. |
Métodos
ApplyPolicy(String) |
Aplica uma política ao formulário usando um arquivo de modelo de política. |