Compartir a través de


User.IsUserMemberOf (Método)

Indica si el usuario es miembro del grupo especificado.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

'Declaración
Public MustOverride Function IsUserMemberOf ( _
    groupName As String _
) As Boolean
'Uso
Dim instance As User
Dim groupName As String
Dim returnValue As Boolean

returnValue = instance.IsUserMemberOf(groupName)
public abstract bool IsUserMemberOf (
    string groupName
)

Parámetros

  • groupName
    Nombre del grupo, con el formato dominio\nombreDeGrupo.

Valor devuelto

true si el usuario actual es miembro del grupo especificado; en caso contrario, false.

Excepciones

Tipo de excepción Condición

ArgumentNullException

El parámetro pasado a este método es null.

ArgumentException

El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.

Comentarios

Aunque el método IsUserMemberOf está marcado como de nivel de seguridad 2, no siempre está accesible. Cuando se llama al método IsUserMemberOf, InfoPath realiza primero una comprobación de seguridad para determinar si se permite el acceso a este método. La comprobación de seguridad confirma si el código de llamada es de confianza y determina su ubicación.

Si el código de llamada es de confianza (por ejemplo, cuando se llama al método IsUserMemberOf desde una plantilla de formulario instalada o firmada de InfoPath, o desde código externo de confianza, como un archivo ejecutable del equipo local), InfoPath permitirá el acceso completo al método IsUserMemberOf.

Si el código de llamada no es de confianza, por ejemplo, si la llamada procede de una plantilla de formulario de InfoPath basada en el dominio, InfoPath comprueba primero desde dónde se hace la llamada. Si procede de código que no es de confianza de una plantilla de formulario de InfoPath de una dirección URL como "https://www.contoso.com/example.xsn", la llamada procede de la zona de Internet. InfoPath denegará el acceso al método IsUserMemberOf a todas las llamadas que no sean de confianza y procedan de la zona de Internet. Si la llamada procede de una dirección URL como "http://contoso/example.xsn", entonces procede de la zona de la intranet. Si una llamada que no es de confianza procede de la zona de la intranet, InfoPath comprueba si la configuración de autenticación del usuario de Internet Explorer admite el inicio de sesión automático (sólo en la zona de la intranet o en todos los inicios de sesión). Si Internet Explorer está configurado para el inicio de sesión automático, InfoPath comprueba la pertenencia a grupos del usuario. Si es pública, InfoPath permite el acceso completo al método IsUserMemberOf. Si la pertenencia a grupos no es totalmente pública, InfoPath oculta el resultado, es decir, InfoPath trata la pertenencia a grupos como si no fuera visible. El valor devuelto en este caso es siempre false, porque la pertenencia a grupos no es pública. InfoPath no informa de que se ha denegado el acceso.

Nota

La información de pertenencia a grupos es totalmente pública si se permite el acceso a ella y la información está visible para todos los usuarios que no sean anónimos. Aunque sólo se ha denegado el acceso a la información de pertenencia a grupos a un único usuario que no sea anónimo, entonces dicha información no es totalmente pública.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro solamente desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007.

Ejemplo

En el siguiente ejemplo, si se hace clic en el control Botón, se muestra si el usuario actual pertenece al 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

Vea también

Referencia

User (Clase)
User (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)