Permission Klasse

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.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.

Stellt Zugriff auf die UserPermissionCollection Berechtigungseinstellungen und bereit, die auf ein Formular angewendet werden können.

public ref class Permission abstract

public abstract class Permission

type Permission = class

Public MustInherit Class Permission

Vererbung: Object
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 instance der Permission-Klasse, die einer Formularvorlage zugeordnet ist, wird von der Microsoft.Office.InfoPath.Xmlform.Permission -Eigenschaft der XmlForm -Klasse zurückgegeben. Das zurückgegebene Permission-Objekt bietet Zugriff auf die Auflistung von UserPermission Objekten, die der Formularvorlage zugeordnet sind, und jedes Formular, das mit dieser Vorlage erstellt instance. 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. Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob ein Formular über eingeschränkte Berechtigungen verfügt.

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 mithilfe von Eigenschaften und Methoden der Permission-Klasse auf eine der folgenden Arten 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(String) -Methode wird aufgerufen.

Berechtigungen für ein Formular können auch mithilfe einer der Methoden der Add(String)UserPermissionCollection-Klasse aktiviert werden, um einen Benutzer zur Sammlung der Benutzerberechtigungen des Formulars 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.

Konstruktoren

Permission()

Stellt Zugriff auf die UserPermissionCollection Berechtigungseinstellungen und bereit, die auf ein Formular angewendet werden können.

Eigenschaften

DocumentAuthor	Ruft den Autor des aktuellen Formulars als E-Mail-Adresse ab, oder legt ihn fest.
Enabled	Ruft ab, ob die durch das Permission-Objekt dargestellten Berechtigungseinstellungen für das aktuelle Formular aktiviert sind, oder legt diese Einstellung fest.
PermissionFromPolicy	Ruft ab, ob eine Berechtigungsrichtlinie auf das aktuelle Formular angewendet wurde.
PolicyDescription	Ruft eine Beschreibung der Richtlinie ab, die auf dem aktuellen Formular angewendet wurde.
PolicyName	Ruft den Namen der Richtlinie ab, die auf dem aktuellen Formular angewendet wurde.
RequestPermissionUrl	Ruft die Datei, den URL oder die E-Mail-Adresse ab, an die sich Benutzer wenden müssen, die zusätzliche Berechtigungen für das aktuelle Formular benötigen, oder legt sie fest.
StoreLicenses	Ruft ab, ob die Benutzerlizenz zum Anzeigen des aktuellen Formulars zwischengespeichert werden soll, um die Offlineanzeige zuzulassen, wenn der Benutzer keine Verbindung zu einem Rechteverwaltungsserver herstellen kann, oder legt diese Einstellung fest.
UserPermissions	Ruft eine UserPermissionCollection für das aktuelle Formular ab.

Methoden

ApplyPolicy(String)

Wendet eine Richtlinie auf das Formular mithilfe einer Richtlinienvorlagendatei an.

Gilt für:

Freigeben über