del método Permission.Add

Artículo
05/12/2015

Crea un nuevo conjunto de permisos en el formulario actual para el usuario especificado con los permisos especificados y una fecha de caducidad.

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

Sintaxis

'Declaración
Function Add ( _
    bstrUserId As String, _
    varPermission As Object, _
    varExpirationDate As Object _
) As UserPermissionObject
'Uso
Dim instance As Permission
Dim bstrUserId As String
Dim varPermission As Object
Dim varExpirationDate As Object
Dim returnValue As UserPermissionObject

returnValue = instance.Add(bstrUserId, _
    varPermission, varExpirationDate)

UserPermissionObject Add(
    string bstrUserId,
    Object varPermission,
    Object varExpirationDate
)

Parámetros

bstrUserId
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. Obligatorio.

varPermission
Tipo: System.Object

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

varExpirationDate
Tipo: System.Object

Fecha de caducidad de los permisos que se conceden, como valor System.DateTime. Opcional.

Valor devuelto

Tipo: Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject
Un objeto UserPermissionObject que representa al usuario especificado.

Comentarios

Para poder tener acceso a los valores de la enumeración MsoPermission a fin de establecer el parámetro varPermission, debe establecer una referencia a la Biblioteca de objetos de Microsoft Office 12.0 en la ficha COM del cuadro de diálogo Agregar referencia de Visual Studio 2012 o Visual Studio. De esta forma se establece una referencia a los miembros del espacio de nombres Microsoft.Office.Core namespace.

Dado que el objeto Permission y sus miembros son nuevos en Microsoft InfoPath, debe convertir el objeto devuelto por la variable thisXDocument en el tipo _XDocument3 para poder tener acceso a este objeto y sus miembros. Para obtener más información, vea Cómo: Usar miembros del modelo de objetos que no son compatibles con InfoPath 2003.

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.

Ejemplos

En el ejemplo siguiente se usa el método Add para agregar un usuario nuevo al formulario, al que se asigna el nivel de acceso de control total, y establecer una fecha de caducidad de dos días a partir de la fecha.

En este ejemplo es necesaria una directiva using o Imports para el espacio de nombres Microsoft.Office.Core en la sección de declaraciones del módulo del formulario.

_XDocument3 thisDoc = (_XDocument3)thisXDocument;

string strExpirationDate = DateTime.Today.AddDays(2).ToString();
DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

thisDoc.Permission.Add("someone@example.com",
   msoPermission.msoPermissionFullControl, dtExpirationDate);

Dim thisDoc As _XDocument3 = DirectCast(thisXDocument, _XDocument3)

Dim strExpirationDate As String = _
   DateTime.Today.AddDays(2).ToString()
dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

thisDoc.Permission.UserPermissions.Add("someone@example.com", _
   msoPermission.msoPermissionFullControl, dtExpirationDate)

Vea también

Referencia

interfaz Permission

Miembros Permission

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust

Compartir a través de