Permission.Add-Methode

Č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.

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(2)> _
Function Add ( _
    bstrUserId As String, _
    varPermission As Object, _
    varExpirationDate As Object _
) As UserPermissionObject
'Usage
Dim instance As Permission
Dim bstrUserId As String
Dim varPermission As Object
Dim varExpirationDate As Object
Dim returnValue As UserPermissionObject

returnValue = instance.Add(bstrUserId, varPermission, varExpirationDate)

[DispIdAttribute(2)] 
UserPermissionObject Add (
    string bstrUserId,
    Object varPermission,
    Object varExpirationDate
)

Parameter

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

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

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

Rückgabewert

UserPermissionObject zur Darstellung des angegebenen Benutzers.

Hinweise

Um auf die MsoPermission-Enumerationswerte zum Festlegen des varPermission-Parameters zuzugreifen, müssen Sie einen Verweis auf die Microsoft Office 12.0 Object Library erstellen. Verwenden Sie hierzu die Registerkarte COM des Dialogfelds Verweis hinzufügen in Microsoft Visual Studio Tools für Anwendungen (VSTA) oder Visual Studio. Hiermit wird ein Verweis auf die Member des Microsoft.Office.Core-Namespaces erstellt.

Da das Permission-Objekt und seine Member in Microsoft Office InfoPath 2007 neu hinzugekommen sind, müssen Sie das von der thisXDocument-Variable zurückgegebene Objekt in den _XDocument3-Typ umwandeln, um auf das Objekt und seine Member zuzugreifen. Weitere Informationen hierzu finden Sie unter Vorgehensweise: Verwenden von nicht mit InfoPath 2003 kompatiblen Microsoft.Office.Interop.InfoPath.SemiTrust-Membern.

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.

Beispiel

Im folgenden Beispiel wird die Add-Methode verwendet, um dem Formular einen neuen Benutzer hinzuzufügen, diesem Benutzer "Vollzugriff" zu erteilen und ein Ablaufdatum zwei Tage vom aktuellen Datum aus festzulegen.

Dieses Beispiel erfordert eine using- oder Imports-Direktive für den Microsoft.Office.Core-Namespace im Deklarationsabschnitt des Formularmoduls.

_XDocument3 thisDoc = (_XDocument3)thisXDocument;

string strExpirationDate = DateTime.Today.AddDays(2).ToString();
DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

thisDoc.Permission.Add("someone@example.com",
   msoPermission.msoPermissionFullControl, dtExpirationDate);

Dim thisDoc As _XDocument3 = DirectCast(thisXDocument, _XDocument3)

Dim strExpirationDate As String = _
   DateTime.Today.AddDays(2).ToString()
dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

thisDoc.Permission.UserPermissions.Add("someone@example.com", _
   msoPermission.msoPermissionFullControl, dtExpirationDate)

Siehe auch

Referenz

Permission-Schnittstelle
Permission-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím