Activation de la journalisation d'activité dans le client EWS pour .NET

La journalisation est utilisée pour le débogage, ainsi que pour collecter et analyser les informations de fonctionnement de l’application. Les fichiers journaux contiennent des informations système sur le fonctionnement de l’application cliente.

Configurer la journalisation à l’aide du fichier appsettings.json

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

Voici les étapes pour activer la journalisation dans EWSClient.

  • Ajoutez un fichier de configuration appsettings.json à un projet C#, s’il n’a pas été ajouté auparavant. Assurez-vous que le fichier projet contient les lignes suivantes dans la section ItemGroup :

    <Content Include="appsettings.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
</Content>

  • Ensuite, ajoutez le contenu suivant au fichier appsettings.json.

    {
  "EWSDiagnosticLog": "ews.log",
  "EWSDiagnosticLog_UseDate": true
}

Il y a deux propriétés :

  • EWSDiagnosticLog - Spécifie le chemin relatif ou absolu du fichier journal.
  • EWSDiagnosticLog_UseDate - indique s’il faut ajouter une représentation sous forme de chaîne de la date actuelle au nom du fichier journal.

Configurer la journalisation 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.

Voici les étapes pour activer la journalisation dans EWSClient.

using (var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", credentials))
{
  client.LogFileName = @"Aspose.Email.EWS.log";
  client.UseDateInLogFileName = false;
}

Configurer la journalisation à l’aide du fichier App.config

Cette option convient aux applications où app.config est la méthode préférée pour conserver la configuration de l’application.

Voici les étapes pour activer la journalisation dans EWSClient.

  • Ajoutez un fichier de configuration d’application à un projet C#, s’il n’a pas déjà été ajouté.
  • Ajoutez le contenu suivant au fichier de configuration.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
      <section name="Aspose.Email.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
    </sectionGroup>
  </configSections>
    <applicationSettings>
        <Aspose.Email.Properties.Settings>
            <setting name="EWSDiagnosticLog" serializeAs="String">
                <value>..\..\..\Log\Aspose.Email.EWS.log</value>
            </setting>
            <setting name="EWSDiagnosticLog_UseDate" serializeAs="String">
                <value>False</value>
            </setting>
        </Aspose.Email.Properties.Settings>
    </applicationSettings>
</configuration>

Il y a deux sections de paramètres :

  • EWSDiagnosticLog - Spécifie le chemin relatif ou absolu du fichier journal.
  • EWSDiagnosticLog_UseDate - indique s’il faut ajouter une représentation sous forme de chaîne de la date actuelle au nom du fichier journal.
Gestion asynchrone des jetons OAuth et des e-mails EWS en C# Gestion avancée des e‑mails pour les applications .NET