Créer des fichiers PST en C#

Les fichiers PST (Personal Storage Table) servent de composant essentiel pour la gestion des données Outlook, facilitant le stockage des e-mails, contacts, calendriers et autres éléments. Dans le domaine du développement C# .NET, le processus de création et de gestion des fichiers de stockage est crucial pour diverses applications.

Dans cet article, nous explorerons comment créer des fichiers PST en utilisant C# .NET. Nous aborderons la création d’un stockage PST vide, l’ajout de dossiers et sous-dossiers, l’incorporation de dossiers standards et réguliers, et enfin, l’ajout d’e-mails et d’éléments Outlook au fichier PST.

API C# pour créer et remplir des fichiers PST

Pour travailler avec des fichiers de stockage au format PST en C#, nous utiliserons Aspose.Email pour .NET. Cette bibliothèque complète est conçue pour les développeurs .NET, offrant des outils puissants pour le traitement des données liées aux e-mails. Avec ses API intuitives, les développeurs peuvent créer, lire et manipuler facilement des structures de stockage PST, y compris l’ajout de dossiers, sous-dossiers et dossiers Outlook standards. La bibliothèque simplifie le traitement des messages e-mail en fournissant des fonctionnalités pour analyser, créer, envoyer, recevoir et convertir des e-mails dans divers formats tels que MSG, EML et MHTML. Aspose.Email permet aux développeurs de gérer efficacement les tâches liées aux e-mails au sein de leurs applications .NET, améliorant la fonctionnalité et la performance tout en offrant des capacités de traitement des e-mails supérieures aux utilisateurs finaux.

Pour tirer parti de la puissance de l’API, vous pouvez soit télécharger sa DLL, soit l’installer depuis NuGet en utilisant la commande suivante :

PM> Install-Package Aspose.Email

Création d’un stockage PST vide minimum

Pour commencer, créons un stockage personnel vide. Cela implique d’initialiser un fichier PST sans aucun élément. L’exemple de code ci-dessous vous montrera comment configurer la structure de base pour un nouveau fichier nommé “sample.pst” avec la version du format de fichier Unicode. Pour créer un nouveau fichier PST, utilisez la méthode PersonalStorage.Create.

// Initialize the PersonalStorage instance
using (var pst = PersonalStorage.Create("sample.pst", FileFormatVersion.Unicode))
{
// Add your code for further operations
}
view raw CreatePst.cs hosted with ❤ by GitHub

Remarque : le minimum PST est de 256 Ko, et contient un dossier racine et un dossier Éléments supprimés.

Ajout de dossiers et sous-dossiers

Une fois que nous avons le stockage PST vide, l’étape suivante consiste à ajouter des dossiers et sous-dossiers pour organiser efficacement nos données. Considérez les sous-sections suivantes et essayez les exemples de code suivants pour effectuer la tâche.

Ajout de dossiers standards

L’ajout de dossiers standards comme Boîte de réception, Boîte d’envoi, Éléments envoyés, Brouillons, etc., est simple avec Aspose.Email. L’exemple de code suivant démontre comment créer un nouveau dossier appelé “Boîte de réception” dans un PST nommé “sample.pst”. Le code utilise la classe PersonalStorage pour ouvrir le fichier PST, puis appelle la méthode CreatePredefinedFolder() pour créer un dossier standard pour les éléments entrants. Le dossier est créé en utilisant le type de dossier prédéfini StandardIpmFolder.inbox, qui représente généralement le dossier Boîte de réception dans les clients de messagerie.

  1. Initialisez un nouvel objet PersonalStorage.
  2. Utilisez la méthode CreatePredefinedFolder de l’instance PersonalStorage (pst) pour créer un dossier standard nommé “Boîte de réception” en spécifiant le type de dossier StandardIpmFolder.Inbox pour indiquer qu’il s’agit d’un dossier de Boîte de réception.
using (var pst = PersonalStorage.Create("sample.pst", FileFormatVersion.Unicode))
{
// Create a standard folder (Inbox)
var inboxFolder = pst.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);
}
view raw AddStandardFolders.cs hosted with ❤ by GitHub

La liste suivante comprend les dossiers standards qui peuvent être ajoutés à un nouveau fichier PST :

  • Boîte de réception
  • Éléments envoyés
  • Calendrier
  • Contacts
  • Journal
  • Notes
  • Tâches
  • Problèmes de synchronisation
  • Courriers indésirables
  • Flux RSS

Ajout de dossiers réguliers

En plus des dossiers standards, les utilisateurs créent souvent des dossiers personnalisés avec des noms spécifiques pour mieux organiser leurs e-mails. L’extrait de code suivant montre comment ajouter un dossier personnalisé à la racine du fichier PST.

  1. Initialisez un nouvel objet PersonalStorage.
  2. Utilisez la méthode AddSubFolder de la propriété RootFolder de l’instance PersonalStorage pour créer un dossier personnalisé.

Après avoir créé le “Dossier personnalisé”, vous pouvez utiliser à nouveau la méthode AddSubFolder pour créer des sous-dossiers à l’intérieur. Fournissez le nom souhaité pour le sous-dossier en tant que paramètre à la méthode AddSubFolder.

using (var pst = PersonalStorage.Create("sample.pst", FileFormatVersion.Unicode))
{
// Create a custom folder
var someFolder = pst.RootFolder.AddSubFolder("SomeFolder");
// Create a subfolder to the "Custom Folder"
var subFolder = customFolder.AddSubFolder("SubFolder");
}
view raw AddRegularFolders.cs hosted with ❤ by GitHub

Ajout d’e-mails et d’éléments Outlook

Avec la structure en place, nous pouvons maintenant peupler notre fichier PST avec des e-mails et d’autres éléments Outlook. Cela implique de créer des e-mails, des rendez-vous, des contacts, des tâches, et plus encore, et de les ajouter aux dossiers appropriés au sein du fichier. Considérons quelques exemples.

Ajout de nouveaux e-mails

L’exemple de code ci-dessous vous montrera comment ajouter un nouveau message e-mail au dossier “Boîte de réception” dans le fichier PST. Le code implique les étapes suivantes :

  1. Initialisez un nouvel objet PersonalStorage.
  2. Récupérez le dossier Boîte de réception en utilisant la méthode GetSubFolder sur la propriété RootFolder de l’instance PersonalStorage.
  3. Instanciez un nouvel objet MapiMessage.
  4. Utilisez la méthode AddMessage sur l’objet inboxFolder pour ajouter le message nouvellement créé (message) au dossier Boîte de réception.
using (var pst = PersonalStorage.Create("sample.pst", FileFormatVersion.Unicode))
{
// Access the folder to add items
var inboxFolder = pst.RootFolder.GetSubFolder("Inbox");
// Create a new message
var message = new MapiMessage("from@example.com", "to@example.com", "Subject", "Body");
// Add the message to the Inbox folder
inboxFolder.AddMessage(message);
}
view raw AddNewEmails.cs hosted with ❤ by GitHub

Ajout d’éléments Outlook

L’exemple de code suivant vous permet d’ajouter un contact à un nouveau fichier PST en tant qu’exemple. Il décrit le processus de création d’un nouveau fichier de stockage personnel, d’ajout d’un dossier standard Contacts, de chargement d’un contact à partir d’un fichier VCF et d’ajout du contact au dossier Contacts. Le code implique les étapes suivantes :

  1. Initialisez un nouvel objet PersonalStorage.
  2. Utilisez la méthode CreatePredefinedFolder pour créer un dossier standard en spécifiant le type de dossier StandardIpmFolder.Contacts pour indiquer qu’il s’agit d’un dossier Contacts.
  3. Utilisez la méthode MapiContact.FromVCard pour charger un contact à partir d’un fichier VCF. Cette méthode crée un objet MapiContact représentant les informations du contact.
  4. Utilisez la méthode AddMapiMessageItem pour ajouter le contact chargé au dossier Contacts.
using (var pst = PersonalStorage.Create("sample.pst", FileFormatVersion.Unicode))
{
// Create a standard folder (Contacts)
var contactsFolder = pst.CreatePredefinedFolder("My Contacts", StandardIpmFolder.Contacts);
// Load a contact from vcf file
var contact = MapiContact.FromVCard("Contact.vcf");
// Add the contact to the folder
contactsFolder.AddMapiMessageItem(contact);
}
view raw AddOutlookItems.cs hosted with ❤ by GitHub

Conclusion

Dans ce tutoriel, nous avons exploré comment créer des fichiers PST en utilisant C# .NET avec la bibliothèque Aspose.Email. De la création d’un stockage PST vide à l’ajout de dossiers, sous-dossiers et divers éléments Outlook, la bibliothèque fournit un ensemble complet de fonctionnalités pour la manipulation des fichiers PST. L’intégration de ces fonctionnalités dans vos applications C# .NET vous permet de gérer efficacement les données Outlook, renforçant la robustesse et la polyvalence de vos solutions logicielles.

En plus de cela, la bibliothèque offre une large gamme de fonctionnalités pour créer, extraire, analyser, convertir et manipuler des e-mails, soutenue par une documentation complète et des exemples de code pour simplifier le processus d’intégration, facilitant aux développeurs la mise en œuvre de solutions liées aux e-mails au sein de leurs applications .NET.

Avec l’API avancée, vous pouvez également accéder en continu à des ressources gratuites :

  • forum de support - une grande communauté pour obtenir des réponses à toutes vos questions
  • blog - des informations inestimables sur les fonctionnalités à jour
  • documentation - tutoriels, exemples de code et meilleures pratiques avec accès aux références API
  • applications gratuites apps pour visualiser ou convertir, fusionner ou analyser des e-mails, analyser des en-têtes, ajouter un filigrane, et plus encore

Aspose.Email s’assure que les développeurs disposent des ressources nécessaires pour surmonter tous les défis et maximiser le potentiel de l’API au sein de leurs applications.

Voir aussi