User.IsUserMemberOf(String) Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Obtém se o usuário atual é um membro do grupo especificado.

public:
 abstract bool IsUserMemberOf(System::String ^ groupName);

public abstract bool IsUserMemberOf (string groupName);

abstract member IsUserMemberOf : string -> bool

Public MustOverride Function IsUserMemberOf (groupName As String) As Boolean

Parâmetros

groupName

String

O nome do grupo no formato domain\groupname.

Retornos

Boolean

true se o usuário atual for um membro do grupo especificado; caso contrário , false.

Exceções

ArgumentNullException

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

ArgumentException

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

Exemplos

No exemplo a seguir, clicar no controle Botão exibe se o usuário atual é um membro do grupo especificado.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   MessageBox.Show(
      this.Application.User.IsUserMemberOf(
      "CONTOSO\\Users").ToString());
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   MessageBox.Show( _
      Me.Application.User.IsUserMemberOf("CONTOSO\\Users").ToString())
End Sub

Comentários

Embora o IsUserMemberOf(String) método seja marcado como nível de segurança 2, nem sempre é acessível. Quando uma chamada é feita ao método, o IsUserMemberOf(String) InfoPath primeiro executa uma marcar de segurança para determinar se o acesso a esse método é permitido. O marcar de segurança confirma se o código de chamada é confiável ou não e determina o local do código de chamada.

Se o código de chamada for confiável (como é quando, por exemplo, o IsUserMemberOf(String) método é chamado de um modelo de formulário InfoPath instalado ou assinado ou de código externo confiável, como um arquivo executável no computador local), o InfoPath permitirá acesso total ao IsUserMemberOf(String) método.

Se o código de chamada não for confiável, por exemplo, se a chamada for proveniente de um modelo de formulário InfoPath baseado em domínio, o InfoPath primeiro verificará de onde a chamada está sendo feita. Se a chamada for de código que não é confiável em um modelo de formulário InfoPath em uma URL como "http://www.contoso.com/example.xsn", a chamada será da zona da Internet. O InfoPath negará acesso IsUserMemberOf(String) ao método para todas as chamadas que não são confiáveis provenientes da zona da Internet. Se a chamada for de uma URL como "http://contoso/example.xsn", a chamada será da zona intranet. Para uma chamada que não é confiável da zona Intranet, o InfoPath verifica se as configurações de autenticação do usuário Explorer internet permitem logon automático (somente na zona Intranet ou em cada logon). Se o Explorer da Internet estiver configurado para logon automático, o InfoPath verificará a associação de grupo do usuário. Se a associação de grupo for pública, o InfoPath permitirá acesso total ao IsUserMemberOf(String) método. Se a associação do grupo não for totalmente pública, o InfoPath ocultará o resultado. Ou seja, o InfoPath trata a associação do grupo como se não estivesse visível. O valor retornado nesse caso é sempre falso porque a associação do grupo não é pública. O InfoPath não informa que o acesso foi negado.

Observação: as informações de associação de grupo são totalmente públicas se o acesso a ela for permitido e as informações estiverem visíveis por todos os usuários não anônimos. Se mesmo um único usuário não anônimo tiver sido especificamente negado acesso a informações de associação, as informações de associação de grupo não serão totalmente públicas.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.