Arbeiten mit Ordnern auf dem Exchange-Server
Alle Ordner vom Server auflisten
Aspose.Email API ermöglicht die Verbindung zum Exchange‑Server sowie das Auflisten aller Ordner und Unterordner. Sie können außerdem alle Unterordner jedes Ordners rekursiv abrufen. Zusätzlich bietet sie die Möglichkeit, Ordner mit Paging vom Exchange‑Client mittels Exchange Web Service (EWS) aufzulisten. Dieser Artikel zeigt, wie man alle Unterordner vom Exchange‑Server abruft und Ordner mit Paginierung listet.
Der folgende Codeausschnitt zeigt, wie man Ordner vom Exchange-Server auflistet.
Ordner‑Typ‑Informationen mit EWS abrufen
Die ExchangeFolderType Enumerator bereitgestellt von ExchangeFolderInfo Klasse kann verwendet werden, um Informationen über den Typ des Ordners zu erhalten. Siehe das untenstehende Code‑Beispiel.
Auflisten von Ordnern mit Paging‑Unterstützung mittels EWS
Das folgende Code‑Snippet zeigt, wie man die Paging‑Unterstützung mit EWS verwendet.
Zugriff auf benutzerdefinierte Postfach‑Ordner oder Unterordner
IEWSClient ermöglicht Entwicklern den Zugriff auf beliebige benutzerdefinierte Ordner oder Unterordner im Postfach. Die FolderExists() Methode von IEWSClient Gibt die URI eines angegebenen benutzerdefinierten Ordners/Unterordners zurück, die anschließend zum Zugreifen auf den Zielordner verwendet werden kann. Im folgenden Beispiel wird ein benutzerdefinierter Ordner namens „TestInbox“, der unter INBOX erstellt wurde, aufgerufen und alle Nachrichten aus diesem benutzerdefinierten Ordner angezeigt. Für diese Aufgabe werden die folgenden Schritte durchgeführt:
- Initialisieren Sie das IEWSClient Objekt, indem gültige Anmeldeinformationen bereitgestellt werden.
- Greifen Sie auf das Standardpostfach zu.
- Greifen Sie auf den übergeordneten Ordner zu, der in diesem Beispiel INBOX ist. Dieser übergeordnete Ordner kann ebenfalls ein benutzerdefinierter Ordner sein.
- Verwenden FolderExists() Methode zum Durchsuchen des angegebenen benutzerdefinierten Unterordners, z. B. „TestInbox“. Sie gibt die URI von „TestInbox“ zurück.
- Verwenden Sie diese URI, um auf alle Nachrichten in diesem benutzerdefinierten Ordner zuzugreifen.
Das folgende Code‑Snippet zeigt, wie Sie benutzerdefinierte Postfach‑Ordner oder Unterordner mit EWS zugreifen.
Auflisten öffentlicher Ordner
Microsoft Exchange Server ermöglicht es Benutzern, öffentliche Ordner zu erstellen und Nachrichten darin zu veröffentlichen. Um dies über Ihre Anwendung zu tun, verwenden Sie das EWSClient Klasse, um eine Verbindung zum Exchange‑Server herzustellen und Nachrichten sowie Beiträge aus öffentlichen Ordnern zu lesen und herunterzuladen. Das folgende Code‑Snippet zeigt, wie man alle öffentlichen Ordner und Unterordner ausliest und alle darin gefundenen Nachrichten auflistet und herunterlädt. Dieses Beispiel funktioniert nur mit Microsoft Exchange Server 2007 oder höher, da nur diese EWS unterstützen.
Synchronisieren von Ordnerelementen
Aspose.Email‑APIs IEWSClient bietet die Möglichkeit, einen Exchange‑Ordner und dessen Inhalt zu synchronisieren. Die SyncFolder Methode, die von IEWSClient Klasse kann verwendet werden, um Ordnerinformationen eines bestimmten Ordners zu synchronisieren. Das folgende Code‑Snippet zeigt, wie man Exchange‑Ordnerinformationen synchronisiert.
Abrufen von Berechtigungen für Exchange‑Ordner
Benutzern werden Berechtigungen für öffentliche Ordner auf dem Exchange‑Server zugewiesen, die das Zugriffslevel eines Benutzers auf diese Ordner einschränken/bestimmen. Die ExchangeFolderPermission-Klasse bietet eine Reihe von Berechtigungseigenschaften für Exchange‑Ordner, wie das Berechtigungsniveau, ob Elemente erstellt, gelöscht werden können und weitere Aufgaben, die durch die Berechtigungseigenschaften festgelegt sind. Berechtigungen können mit der GetFolderPermissions() Methode von IEWSClient. Dieser Artikel zeigt, wie man die auf einen öffentlichen Ordner angewendeten Berechtigungen für alle Benutzer, die Zugriff auf die freigegebenen Ordner haben, abruft.
Um diese Aufgabe auszuführen:
- Initialisieren Sie das IEWSClient.
- Verwenden Sie die ListPublicFolders um eine Liste aller öffentlichen Ordner zu erhalten
- Rufen Sie die mit einem Ordner verbundenen Berechtigungen ab, indem Sie die GetFolderPermissions() Methode
Das folgende Code‑Snippet zeigt, wie Sie die IEWSClient Klasse zum Abrufen von Berechtigungen, die auf einen Ordner angewendet wurden.
Erstellen von Ordnern und Unterordnern
Aspose.Email API bietet die Möglichkeit, Ordner in einem Exchange‑Postfach zu erstellen. Die CreateFolder Methode von IEWSClient kann für diesen Zweck verwendet werden. Um einen Ordner im Exchange‑Server‑Postfach zu erstellen, können die folgenden Schritte verwendet werden.
- Erstellen Sie eine Instanz von IEWSClient.
- Setzen Sie die set_UseSlashAsFolderSeparator Eigenschaft nach Bedarf. Wenn auf true gesetzt, betrachtet die Anwendung den "Slash" als Ordnertrennzeichen und der Unterordner wird nach dem Schrägstrich erstellt.
- Verwenden Sie die CreateFolder Methode zum Erstellen des Ordners.
Das folgende Codebeispiel zeigt, wie man Ordner und Unterordner erstellt.
Exchange‑Ordner in PST sichern
Es kommt häufig vor, dass Benutzer ein Backup aller oder einiger Postfachordner erstellen möchten. Aspose.Email bietet die Möglichkeit, ein Backup aller oder bestimmter Exchange‑Postfachordner in eine PST zu erstellen. Um ein Backup von Exchange‑Server‑Ordnern zu erstellen, können die folgenden Schritte ausgeführt werden.
- Erstellen Sie eine Instanz von IEWSClient.
- Fügen Sie die erforderlichen Ordnerinformationen zu ExchangeFolderInfoCollection
- Verwenden IEWSClient->Backup Methode, um den Inhalt des Ordners in eine PST zu exportieren.
Das folgende Codebeispiel zeigt, wie man Exchange‑Ordner in eine PST-Datei sichert.