UserPermissionCollection.Add-Methode (String, DateTime)

Artikel
04/27/2010

Fügt dem aktuellen Formular einen neuen Benutzer mit Ablaufdatum hinzu.

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

Syntax

'Declaration
Public MustOverride Function Add ( _
    userId As String, _
    expirationDate As DateTime _
) As UserPermission
'Usage
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
)

Parameter

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

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

Rückgabewert

Ein UserPermission-Objekt, das den angegebenen Benutzer darstellt.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der an diese Methode übergebene Parameter ist null.
ArgumentException	Der an diese Methode übergebene Parameter ist ungültig. Er weist 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 dem aktuellen Formular ein neuer Benutzer hinzugefügt 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",
      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

Siehe auch

Referenz

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

Freigeben über