.NET 用 EWS クライアントでのアクティビティ ロギングの有効化

ロギングはデバッグだけでなく、アプリケーションの稼働情報を収集・分析するために使用されます。ログファイルにはクライアント アプリケーションの動作に関するシステム情報が含まれます。

appsettings.json ファイルでロギングを設定

注: このオプションは .NET Core アプリケーションに推奨されます。

ロギングを有効にする手順は以下の通りです EWSClient.

  • まだ追加されていない場合は、C# プロジェクトに appsettings.json 構成ファイルを追加します。プロジェクト ファイルの ItemGroup セクションに以下の行が含まれていることを確認してください:

    <Content Include="appsettings.json">
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Content>
    
  • 次に、appsettings.json ファイルに以下の内容を追加します。

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

プロパティは2つあります:

  • 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>

設定セクションは2つあります:

  • EWSDiagnosticLog - ログファイルへの相対パスまたは絶対パスを指定します。
  • EWSDiagnosticLog_UseDate - ログファイル名に現在の日付の文字列表現を追加するかどうかを指定します。