UserPermissionCollection.Add-Methode (String, PermissionType, DateTime)

Článek
04/27/2010

Erstellt eine neue Berechtigungsgruppe für das aktuelle Formular für den angegebenen Benutzer mit den angegebenen Berechtigungen und einem Ablaufdatum.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Function Add ( _
    userId As String, _
    permission As PermissionType, _
    expirationDate As DateTime _
) As UserPermission
'Usage
Dim instance As UserPermissionCollection
Dim userId As String
Dim permission As PermissionType
Dim expirationDate As DateTime
Dim returnValue As UserPermission

returnValue = instance.Add(userId, permission, expirationDate)

public abstract UserPermission Add (
    string userId,
    PermissionType permission,
    DateTime expirationDate
)

Parameter

userId
Die E-Mail-Adresse im Format "benutzer@domaene.com" des Benutzers, dem Berechtigungen für das aktuelle Formular erteilt werden.

permission
Die Berechtigungen für das aktuelle Formular, die dem angegebenen Benutzer erteilt werden, als Kombination aus einem oder mehreren PermissionType-Werten.

expirationDate
Das Ablaufdatum für die Berechtigungen, die erteilt werden, als System.DateTime-Wert.

Rückgabewert

UserPermission zur Darstellung des angegebenen Benutzers.

Ausnahmen

Ausnahmetyp	Bedingung
FormatException	Der bereitgestellte DateTime-Wert ist ungültig.
ArgumentNullException	Die an diese Methode übergebenen Parameter sind null.
ArgumentException	Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen z. B. den falschen Typ oder das falsche Format auf.
SecurityException	Die Formularvorlage ist nicht für die Sicherheitsebene Voll vertrauenswürdig konfiguriert (Kategorie Sicherheit und Vertrauensstellung im Dialogfeld Formularoptionen).

Hinweise

Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie "Sicherheit und Vertrauensstellung" des Dialogfelds "Formularoptionen" konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Using Libraries from Partially Trusted Code" (in Englisch) auf MSDN.

Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel wird durch Klicken auf das Steuerelement Schaltfläche das UserPermissionsCollection-Element für das aktuelle Formular abgerufen. Dann wird ein Benutzer hinzugefügt und die "Full Control"-Zugriffsebene zugewiesen und ein Ablaufdatum von zwei Tagen ab dem aktuellen Datum festgelegt.

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", 
      PermissionType.FullControl, 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", _
      PermissionType.FullControl, dtExpirationDate)
End Sub

Siehe auch

Referenz

UserPermissionCollection-Klasse
UserPermissionCollection-Member
Microsoft.Office.InfoPath-Namespace

Sdílet prostřednictvím