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

Artículo
05/12/2015

Añada un nuevo usuario al formulario actual con una fecha de caducidad.

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, _
    expirationDate As DateTime _
) As UserPermission
'Uso
Dim instance As UserPermissionCollection
Dim userId As String
Dim expirationDate As DateTime
Dim returnValue As UserPermission

returnValue = instance.Add(userId, expirationDate)

public abstract UserPermission Add(
    string userId,
    DateTime expirationDate
)

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.

expirationDate
Tipo: System.DateTime

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

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, se añade un nuevo usuario al formulario y se establece una fecha de caducidad de dos días a partir de la fecha corriente.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com",
      dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      dtExpirationDate)
End Sub