(String, PermissionType) del método UserPermissionCollection.Add

Artículo
05/12/2015

Añade un nuevo usuario con los permisos especificados.

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

Sintaxis

'Declaración
Public MustOverride Function Add ( _
    userId As String, _
    permission As PermissionType _
) As UserPermission
'Uso
Dim instance As UserPermissionCollection
Dim userId As String
Dim permission As PermissionType
Dim returnValue As UserPermission

returnValue = instance.Add(userId, permission)

public abstract UserPermission Add(
    string userId,
    PermissionType permission
)

Parámetros

userId
Tipo: System.String

Dirección de correo electrónico, con el formato usuario@dominio.com, del usuario al que se van a conceder permisos en el formulario actual.

permission
Tipo: Microsoft.Office.InfoPath.PermissionType

Permisos del formulario actual que se van a conceder al usuario concreto como combinación de uno o varios valores PermissionType.

Valor devuelto

Tipo: Microsoft.Office.InfoPath.UserPermission
Objeto UserPermission que representa al usuario especificado.

Excepciones

Excepción	Condición
ArgumentNullException	El parámetro pasado a este método es una referencia null (Nothing en Visual Basic).
ArgumentException	El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.
SecurityException	La plantilla del formulario no está configurada para Plena confianza utilizando la categoría Seguridad y confianza del cuadro de diálogo Opciones de formulario.

Comentarios

Solo se puede acceder a este miembro con formularios abiertos desde una plantilla de formulario que haya sido configurada para ejecutarse con confianza total usando la categoría Seguridad y confianza del cuadro de diálogo Opciones de formulario. Este miembro requiere confianza total para el autor de llamada inmediato y no se puede utilizar en un código de confianza parcial. Si desea más información, consulte "Utilizar bibliotecas de código que no es de plena confianza" en MSDN.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.

Ejemplos

En el ejemplo siguiente, si se hace clic en el control Botón, se obtiene la colección UserPermissionsCollection del formulario actual y, a continuación, se añade un usuario, al que se asigna el nivel de acceso de control total.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl)
End Sub