Permission-Klasse
Bietet Zugriff auf UserPermissionCollection und Berechtigungseinstellungen, die auf ein Formular angewendet werden können.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.Permission
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class Permission
'Usage
Dim instance As Permission
public abstract class Permission
Hinweise
Verwenden Sie die Permission-Klasse und deren Mitglieder, um die Berechtigungen auf das aktive Formular einzuschränken und bestimmte Berechtigungseinstellungen abzurufen oder festzulegen.
Eine Instanz der Permission-Klasse, die mit einer Formularvorlage verknüpft ist, wird von der Permission()-Eigenschaft der XmlForm-Klasse zurückgegeben. Das zurückgegebene Permission-Objekt bietet Zugriff auf die Auflistung von UserPermission-Objekten, die mit der Formularvorlage verknüpft sind, und jede Formularinstanz, die mit dieser Vorlage erstellt wurde. Jedes UserPermission-Objekt dient zum Definieren einer bestimmten Regelgruppe für einen einzelnen Benutzer. Während einige Berechtigungen, die über die Benutzeroberfläche erteilt werden, auf alle Benutzer angewendet werden, können Sie das UserPermission-Objekt verwenden, um die Berechtigung auf einer benutzerbezogenen Basis mit benutzerbezogenem Ablaufdatum zuzuweisen.
Das Permission-Objekt und seine Eigenschaften und Methoden sind unabhängig davon verfügbar, ob die Berechtigungen für die aktive Formularvorlage eingeschränkt sind oder nicht. Mithilfe der Enabled-Eigenschaft können Sie bestimmen, ob ein Formular eingeschränkte Berechtigungen hat.
Wenn der Client für die Windows-Rechteverwaltung nicht auf einem Benutzercomputer installiert ist, löst die Verwendung der Permission-Klasse eine Ausnahme aus.
Berechtigungen für ein Formular werden auf eine der folgenden Arten mithilfe von Eigenschaften und Methoden der Permission-Klasse aktiviert:
Die Enabled-Eigenschaft ist auf true festgelegt.
Die DocumentAuthor-Eigenschaft ist festgelegt.
Die RequestPermissionUrl-Eigenschaft ist festgelegt.
Die StoreLicenses-Eigenschaft ist auf true oder false festgelegt.
Die ApplyPolicy-Methode wird aufgerufen.
Berechtigungen für ein Formular können auch mithilfe einer der Add-Methoden der UserPermissionCollection-Klasse aktiviert werden, um der Benutzerberechtigungsauflistung des Formulars einen Benutzer hinzuzufügen.
Hinweis
Berechtigungen können nicht angewendet werden, wenn sich ein Formular im Vorschaumodus befindet. Aus diesem Grund sind alle Eigenschaften der Permission-Klasse schreibgeschützt, wenn die Vorschau für ein Formular angezeigt wird. Im Vorschaumodus gibt die Enabled-Eigenschaft immer false zurück, und wenn der Code versucht, diese Einstellung zu ändern, wird System.Runtime.InteropServices.COMException ausgelöst und der Fehler "Die Eigenschaft/Methode ist im Vorschaumodus nicht verfügbar" zurückgegeben. Auf ähnliche Weise geben die Eigenschaften und Methoden, die mit den Klassen UserPermission und UserPermissionCollection verknüpft sind, diese Fehlermeldung zurück, wenn sie im Vorschaumodus verwendet werden.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.