UserPermissionCollection.Add-Methode (String)

Artikel
04/27/2010

Fügt dem aktuellen Formular einen neuen Benutzer hinzu.

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

Syntax

'Declaration
Public MustOverride Function Add ( _
    userId As String _
) As UserPermission
'Usage
Dim instance As UserPermissionCollection
Dim userId As String
Dim returnValue As UserPermission

returnValue = instance.Add(userId)

public abstract UserPermission Add (
    string userId
)

Parameter

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

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 und dann ein neuer Benutzer hinzugefügt.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com");
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com")
End Sub

Siehe auch

Referenz

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

Freigeben über