Включение журналирования активности в EWS‑клиенте для .NET

Журналирование используется для отладки, а также для сбора и анализа рабочей информации о приложении. Файлы журнала содержат системную информацию о работе клиентского приложения.

Настройка журналирования с помощью файла appsettings.json

ПРИМЕЧАНИЕ: Этот параметр предпочтителен для приложений .NET Core.

Ниже приведены шаги для включения журналирования в EWSClient.

  • Добавьте файл конфигурации appsettings.json в проект C#, если он ещё не добавлен. Убедитесь, что файл проекта содержит следующие строки в секции ItemGroup:

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

  • Затем добавьте следующее содержимое в файл appsettings.json.

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

Есть два свойства:

  • EWSDiagnosticLog - Указывает относительный или абсолютный путь к файлу журнала.
  • EWSDiagnosticLog_UseDate - указывает, следует ли добавлять строковое представление текущей даты к имени файла журнала.

Настройка журналирования в программном коде

Вы также можете включить журналирование непосредственно в коде.

ПРИМЕЧАНИЕ: даже если вы уже включили журналирование с помощью файлов конфигурации, этот параметр будет применён.

Ниже приведены шаги для включения журналирования в EWSClient.

  • Создайте EWSClient.
  • Установите путь к файлу журнала, используя LogFileName свойство.
  • Установите UseDateInLogFileName свойство, если это необходимо.
using (var client = EWSClient.GetEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", credentials))
{
  client.LogFileName = @"Aspose.Email.EWS.log";
  client.UseDateInLogFileName = false;
}

Настройка журналирования с помощью файла App.config

Этот параметр подходит для приложений, где app.config является предпочтительным способом хранения конфигурации приложения.

Ниже приведены шаги для включения журналирования в EWSClient.

  • Добавьте файл конфигурации приложения в проект C#, если он ещё не добавлен.
  • Добавьте следующее содержимое в файл конфигурации.
<?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>

Есть два раздела настроек:

  • EWSDiagnosticLog - Указывает относительный или абсолютный путь к файлу журнала.
  • EWSDiagnosticLog_UseDate - указывает, следует ли добавлять строковое представление текущей даты к имени файла журнала.
Асинхронный OAuth токен и управление электронной почтой EWS на C# Продвинутое управление электронной почтой для приложений .NET