<filters>

filters 要素は、ログに記録されるメッセージの種類の制御に使用される XPath フィルターのコレクションを保持します。

フィルターは、logMessagesAtTransportLevel を true に設定することによって指定されるトランスポート層でのみ適用されます。 サービス レベルおよび形式が正しくないメッセージ ログ記録は、フィルターの影響を受けません。

コレクションにフィルターを追加するには、add を使用します。 1 つ以上のフィルターを定義した場合は、少なくとも 1 つのフィルターと一致するメッセージだけが記録されます。 フィルターを定義しなかった場合は、すべてのメッセージが通過します。

フィルターは、完全な XPath 構文をサポートし、構成ファイルでの出現順に適用されます。 フィルターが構文的に正しくない場合は、構成例外が発生します。

SOAP ヘッダー セクションがあるメッセージだけを記録するフィルターの設定方法の例を次に示します。

<messageLogging logEntireMessage="true"
                logMalformedMessages="true"
                logMessagesAtServiceLevel="true"
                logMessagesAtTransportLevel="true"
                maxMessagesToLog="420">
  <filters>
    <add xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
      /soap:Envelope/soap:Headers
    </add>
  </filters>
</messageLogging>

関連項目

• DiagnosticSection
• System.ServiceModel.Diagnostics
• MessageLogging
• MessageLoggingElement
• Filters
• XPathMessageFilterElementCollection
• XPathMessageFilterElement
• XPathMessageFilter
• メッセージ ログの構成
• <messageLogging>