Permission.Add(String, Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::UserPermissionObject ^ Add(System::String ^ bstrUserId, System::Object ^ varPermission, System::Object ^ varExpirationDate);

public Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject Add (string bstrUserId, object varPermission, object varExpirationDate);

abstract member Add : string * obj * obj -> Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject

Public Function Add (bstrUserId As String, varPermission As Object, varExpirationDate As Object) As UserPermissionObject

Parameter

bstrUserId: String

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

varPermission: Object

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

varExpirationDate: Object

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

Gibt zurück

UserPermissionObject

Eine UserPermissionObject , die den angegebenen Benutzer darstellt.

Beispiele

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)

Hinweise

Um auf die MsoPermission Enumerationswerte zum Festlegen des varPermission Parameters zuzugreifen, müssen Sie einen Verweis auf die Microsoft Office 14.0-Objektbibliothek über die Registerkarte COM des Dialogfelds Verweis hinzufügen in Visual Studio 2012 oder Visual Studio festlegen. Dadurch wird ein Verweis auf die Member des Microsoft.Office.Core-Namespaces hergestellt.

Da das Permission-Objekt und seine Member neu in Microsoft InfoPath sind, müssen Sie das von der thisXDocument-Variable zurückgegebene Objekt in den _XDocument3 Typ umwandeln, um auf dieses Objekt und seine Member zuzugreifen. Weitere Informationen hierzu finden Sie unter Vorgehensweise: Verwenden von Objektmodellmembern, die nicht mit InfoPath 2003 kompatibel sind.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

Gilt für: