Vorgehensweise: Arbeiten mit IRM-Einstellungen

In Microsoft Office InfoPath 2007 sind zwei Typen von RIM-Einstellungen (Information Rights Management, Verwaltung von Informationsrechten) verfügbar: einer zum Schützen des Zugriffs auf InfoPath-Formularvorlagen und einer zum Steuern des Zugriffs auf und der Aktionen für Formulardaten, die in fertig gestellten Formularen enthalten sind. Klicken Sie im Menü Datei auf Anmeldeinformationen verwalten, um beim Entwerfen einer Formularvorlage mit diesen Einstellungen zu arbeiten. Klicken Sie im Menü Datei auf Berechtigung, und klicken Sie dann auf Anmeldeinformationen verwalten, um beim Ausfüllen eines Formulars mit diesen Einstellungen zu arbeiten. Weitere Informationen zum Verwenden des Dialogfelds Berechtigung in InfoPath finden Sie im Thema zum Erstellen einer Formularvorlage mit eingeschränkter Berechtigung in der InfoPath-Hilfe.

Hinweis:
Das Einschränken der Berechtigung ist nur für Formularvorlagen verfügbar, die mit InfoPath kompatibel sind. Von browserkompatiblen Formularvorlagen wird IRM nicht unterstützt. Wenn beim Entwerfen einer Formularvorlage Anmeldeinformationen verwalten im Menü Datei nicht angezeigt wird, überprüfen Sie die Kompatibilitätseinstellungen.

Das IRM-Objektmodell

Verwenden Sie die Permission-Klasse, um auf UserPermissionCollection und IRM-Berechtigungseinstellungen zuzugreifen, die auf ein Formular angewendet werden können. Verwenden Sie die Permission-Eigenschaft der XmlForm-Klasse, um auf das einer Formularvorlage zugeordnete Permission-Objekt zuzugreifen. Das zurückgegebene Permission-Objekt stellt den Zugriff auf die Auflistung von UserPermission-Objekten bereit, die der Formularvorlage zugeordnet sind, und auf alle Formularinstanzen, die mit dieser Vorlage erstellt wurden.

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.

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.

Hinweis:
Wenn der Client für die Windows-Rechteverwaltung nicht auf einem Benutzercomputer installiert ist, löst die Verwendung der Permission-Klasse eine Ausnahme aus.

Verwenden Sie die Klassen UserPermissionCollection und UserPermission, um programmgesteuert mit IRM-Einstellungen einzelner Benutzer in Formularen zu arbeiten.

Ein UserPermission-Objekt ordnet eine Berechtigungsgruppe für das aktuelle Formular mit einem einzelnen Benutzer und einem optionalen Ablaufdatum zu. Verwenden Sie die Add-Methode der UserPermissionCollection-Klasse, um einen Benutzer hinzuzufügen und ihm eine Gruppe von Berechtigungen für das aktuelle Formular zu gewähren. Verwenden Sie die Remove-Methode der UserPermissionCollection-Klasse, um einen Benutzer und dessen Berechtigungen zu entfernen. Während einige Berechtigungen, die über die Benutzeroberfläche gewährt werden, auf alle Benutzer angewendet werden, z. B. Drucken und Ablaufdatum, können Sie die Klassen UserPermission und UserPermissionCollection verwenden, um die Berechtigungen auf einer benutzerbezogenen Basis mit benutzerbezogenem Ablaufdatum zuzuweisen. Mithilfe des Objektmodells können Entwickler Berechtigungseinstellungen in einem Formular auflisten und Funktionalität bereitstellen, die Formularbenutzern ermöglicht, dem Formular Berechtigungen hinzuzufügen, ohne den Aufgabenbereich Formularberechtigung oder das Dialogfeld Berechtigung zu verwenden.

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 Methoden, die den Klassen UserPermission und UserPermissionCollection zugeordnet sind, diese Fehlermeldung zurück, wenn sie im Vorschaumodus verwendet werden.

Übersicht über die "Permission"-Klasse

Die UserPermissionCollection-Klasse stellt die folgenden Eigenschaften und eine Methode bereit.

Übersicht über die "UserPermissionCollection"-Klasse

Die UserPermissionCollection-Klasse stellt die folgenden Eigenschaften und Methoden bereit.

Übersicht über die "UserPermission"-Klasse

Die UserPermission-Klasse stellt die folgenden Eigenschaften und eine Methode bereit.

Die "PermissionType"-Enumeration

Die Berechtigungen eines Benutzers werden mithilfe von PermissionType-Enumerationswerten festgelegt oder gelesen.

Beispiel

Im folgenden Beispiel wird durch Klicken auf das Steuerelement Schaltfläche das UserPermissionsCollection-Element für das aktuelle Formular abgerufen. Dann wird ein Benutzer hinzugefügt und der Change-Zugriffsebene zugewiesen und ein Ablaufdatum von zwei Tagen ab dem aktuellen Datum festgelegt.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.Change, dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.Change, dtExpirationDate)
End Sub