Activer et configurer la journalisation d'activité IMAP dans les applications .NET

La journalisation d’activité est utilisée pour le débogage, ainsi que pour la collecte et l’analyse d’informations de fonctionnement sur le client IMAP.

Activer la journalisation d’activité

Utiliser le fichier appsettings.json pour activer la journalisation d’activité

NOTE: Cette option est préférable pour les applications .NET Core.

Connexion ImapClient peut être activé avec les étapes et exemples de code suivants :

  1. Ajoutez un fichier de configuration appsettings.json à un projet C#, s’il n’a pas encore été ajouté.

  2. Assurez‑vous que le fichier de projet contient les lignes suivantes dans la section ItemGroup.

       <Content Include="appsettings.json">
           <CopyToOutputDirectory>Always</CopyToOutputDirectory>
       </Content>
    
  3. Ensuite, ajoutez le contenu suivant au fichier appsettings.json.

       {
         "ImapDiagnosticLog": "imap.log",
         "ImapDiagnosticLog_UseDate": true
       }
    

Les deux propriétés mentionnées ci‑dessus sont :

  • ImapDiagnosticLog - indique le chemin relatif ou absolu du fichier de journal.

  • ImapDiagnosticLog_UseDate - indique s’il faut ajouter une représentation chaîne de la date actuelle au nom du fichier de journal.

Activer la journalisation d’activité dans le code du programme

Vous pouvez également activer la journalisation immédiatement dans le code.

NOTE: même si vous avez déjà activé la journalisation en utilisant des fichiers de configuration, cette option sera appliquée.

Connexion ImapClient peut être activé avec les étapes et exemples de code suivants :

  1. Créez un ImapClient.
  2. Définissez le chemin du fichier journal à l’aide de LogFileName propriété.
  3. Définissez le UseDateInLogFileName propriété si nécessaire.
   using (var client = new ImapClient("your imap server", 993, "your username", "your password"))
{
    // Set security mode
    client.SecurityOptions = SecurityOptions.Auto;

    // Set the path to the log file using the LogFileName property.
    client.LogFileName = @"C:\Aspose.Email.IMAP.log";

    // Set the UseDateInLogFileName property if it is necessary.
    client.UseDateInLogFileName = false;
}

Utiliser le fichier App.config pour activer la journalisation d’activité

ImapClient l’activité peut être journalisée en modifiant les configSections dans le fichier de configuration. Voici les étapes pour effectuer la journalisation de diagnostic :

  1. Ajoutez un sectionGroup appelé "applicationSettings".
  2. Ajoutez une section appelée "Aspose.Email.Properties.Settings".
  3. Incluez le paramètre ImapDiagonosticLog où le nom de fichier est défini dans applicationSettings/Aspose.Email.Properties.Settings.

Voici un exemple d’application formulaire qui utilise ImapClient pour traiter le courrier. Toute cette activité est journalisée en modifiant le fichier App.config.

  • Créez une application basée sur un formulaire avec un seul bouton. Ajoutez le code d’exemple suivant pour le clic du bouton :
  • Ajoutez une référence à Aspose.Email.
todo:image_alt_text  
  • Ajoutez maintenant le fichier App.Config et modifiez‑le afin que son contenu soit le suivant :

Pour C# .NET, utilisez l’option suivante

|todo:image_alt_text| | | :- | :- | Pour VB .NET utilisez l’option suivante

todo:image_alt_text   todo:image_alt_text  
todo:image_alt_text  
  • Exécutez le code puis observez le dossier Log. Le fichier suivant sera généré.
todo:image_alt_text