Lavorare con le cartelle su Exchange Server
Elencare tutte le cartelle dal server
L’API Aspose.Email fornisce la possibilità di connettersi a Exchange Server e elencare tutte le cartelle e le sottocartelle. È inoltre possibile recuperare tutte le sottocartelle di ogni cartella in modo ricorsivo. Fornisce anche la capacità di enumerare le cartelle con paging dal client Exchange usando Exchange Web Services (EWS). Questo articolo mostra come recuperare tutte le sottocartelle dal server Exchange e recuperare le cartelle con paginazione.
Il seguente frammento di codice mostra come elencare le cartelle da Exchange Server.
Ottenere informazioni sul tipo di cartella utilizzando EWS
Il ExchangeFolderType enumeratore fornito da ExchangeFolderInfo la classe può essere usata per ottenere informazioni sul tipo della cartella. Come mostrato nell’esempio di codice qui sotto.
Enumerazione delle cartelle con supporto paging usando EWS
Il seguente frammento di codice mostra come utilizzare il supporto al paging con EWS.
Accesso a cartelle personalizzate o sottocartelle della casella di posta
IEWSClient consente agli sviluppatori di accedere a qualsiasi cartella o sottocartella personalizzata dalla casella di posta. Il FolderExists() metodo di IEWSClient restituisce l’URI di una cartella/sottocartella personalizzata specificata, che può poi essere usato per accedere alla cartella di destinazione. Nell’esempio seguente, una cartella personalizzata chiamata "TestInbox", creata sotto INBOX, viene accessa e tutti i messaggi vengono visualizzati da questa cartella personalizzata. Per eseguire questa operazione, vengono eseguiti i seguenti passaggi:
- Inizializza il IEWSClient oggetto fornendo credenziali valide.
- Accedi alla casella di posta predefinita.
- Accedi alla cartella genitore, che è INBOX in questo esempio. Questa cartella genitore può anche essere una cartella personalizzata.
- Usa FolderExists() metodo per cercare la sottocartella personalizzata specificata, ad esempio "TestInbox". Restituirà l’URI di "TestInbox".
- Usa questo URI per accedere a tutti i messaggi in quella cartella personalizzata.
Il seguente frammento di codice mostra come accedere a cartelle personalizzate della casella di posta o sottocartelle con EWS.
Elenco delle cartelle pubbliche
Microsoft Exchange Server permette agli utenti di creare cartelle pubbliche e pubblicare messaggi al loro interno. Per farlo tramite la tua applicazione, usa il EWSClient classe per connettersi a Exchange Server e leggere e scaricare messaggi e post dalle cartelle pubbliche. Il seguente frammento di codice mostra come leggere tutte le cartelle pubbliche e le relative sottocartelle, elencare e scaricare eventuali messaggi trovati in queste cartelle. Questo esempio funziona solo con Microsoft Exchange Server 2007 o versioni successive, poiché solo queste supportano EWS.
Sincronizzazione degli elementi della cartella
API di Aspose.Email IEWSClient fornisce la funzionalità di sincronizzare una cartella Exchange per i suoi contenuti. Il SyncFolder metodo esposto da IEWSClient classe può essere usata per sincronizzare le informazioni di una cartella specificata. Il seguente frammento di codice mostra come sincronizzare le informazioni della cartella Exchange.
Recupero delle autorizzazioni per le cartelle Exchange
Agli utenti vengono assegnati permessi sulle cartelle pubbliche di Exchange Server, che limitano/determinano il livello di accesso che un utente ha a queste cartelle. La classe ExchangeFolderPermission fornisce un insieme di proprietà di permesso per le cartelle Exchange come il livello di permesso, la possibilità di creare elementi, eliminare elementi e svolgere altre operazioni come specificato dalle proprietà di permesso. I permessi possono essere ottenuti utilizzando il GetFolderPermissions() metodo di IEWSClient. Questo articolo mostra come recuperare le autorizzazioni applicate a una cartella pubblica per tutti gli utenti che hanno accesso alle cartelle condivise.
Per eseguire questa operazione:
- Inizializza il IEWSClient.
- Usa il ListPublicFolders per ottenere un elenco di tutte le cartelle pubbliche
- Recupera i permessi associati a una cartella usando il GetFolderPermissions() metodo
Il seguente frammento di codice mostra come utilizzare il IEWSClient classe per recuperare le autorizzazioni applicate a una cartella.
Creare Cartelle e Sottocartelle
L’API Aspose.Email offre la possibilità di creare cartelle in una casella Exchange. Il CreateFolder metodo di IEWSClient può essere usato a questo scopo. Per creare una cartella nella casella di posta del server Exchange, è possibile seguire i seguenti passaggi.
- Crea un’istanza di IEWSClient.
- Imposta il set_UseSlashAsFolderSeparator proprietà come richiesto. Se impostata su true, l’applicazione considererà lo "Slash" come separatore di cartelle e la sottocartella sarà creata dopo lo slash.
- Usa il CreateFolder metodo per creare la cartella.
Il seguente frammento di codice mostra come creare cartelle e sotto-cartelle.
Backup delle cartelle Exchange in PST
Spesso succede che gli utenti vogliano eseguire il backup di tutte o alcune delle cartelle della casella di posta. Aspose.Email offre la possibilità di eseguire il backup di tutte o di cartelle specifiche della casella di posta Exchange in un file PST. Per eseguire il backup delle cartelle del server Exchange, è possibile seguire i seguenti passaggi.
- Crea un’istanza di IEWSClient.
- Aggiungi le informazioni della cartella richieste a ExchangeFolderInfoCollection
- Usa IEWSClient->Backup metodo per esportare il contenuto della cartella in PST
Il seguente frammento di codice mostra come eseguire il backup delle cartelle Exchange in PST.