UserPermissionCollection.Add-Methode (String, PermissionType)

Artikel
09/24/2014

Fügt einen neuen Benutzer mit den angegebenen Berechtigungen hinzu.

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 _
) As UserPermission
'Usage
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
)

Parameter

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

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

Rückgabewert

Typ: Microsoft.Office.InfoPath.UserPermission
Ein UserPermission-Objekt, das den angegebenen Benutzer darstellt.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der an diese Methode übergebene Parameter ist ein Nullverweis (Nothing in Visual Basic).
ArgumentException	Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise 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 "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code" auf MSDN.

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

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Schaltfläche-Steuerelement das UserPermissionsCollection-Element für das aktuelle Formular abgerufen und dann ein neuer Benutzer hinzugefügt und die Full Control-Zugriffsebene zugewiesen.

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