Configuring the Application Block

Microsoft Enterprise Library 5.0

DropDown image DropDownHover image Collapse image Expand image CollapseAll image ExpandAll image Copy image CopyHover image

The following procedure describes how to configure the Logging Application Block properties.

To configure the Logging Application Block

  1. In the Logging Settings section, click each property you want to change. For information about the Logging Application Block properties, see the table that follows this procedure.
  2. Set the properties if you need to. If you want to use a default category, click the drop-down arrow and select one of the category names. Log entries that are not assigned to a category belong to the default category.
  3. The Warn If No Category Match property sends log entries that are assigned to a category that is not specified in configuration to the Logging Errors & Warnings special source. The default is True. If you do not want this to occur, click False in the drop-down list.
  4. The Activity Tracing Enabled property specifies whether activity tracing is enabled. The default is True. If you do not want this to occur, click False in the drop-down list.

Logging Application Block Properties

The following table lists the properties that appear in the Logging Settings section of the Logging Application Block configuration.

Attribute

Description

Activity Tracing Enabled

Specifies whether activity tracing is enabled. Possible values are True or False. The default is True.

Default Logging Category

Log entries go to this category if no other category is specified. The default is General. This is required.

Protection Provider

The protection provider that should be used to encrypt the log file entries..

Require Permission

Indicates whether to run your application in partial trust mode. Possible values are True or False. The default is True, which allows the application to run in partial trust modes.

Revert Impersonation

Specifies whether to opt out of impersonation-reverting. To opt out of the impersonation-reverting default mode, set RevertImpersonation to False. Support includes configuration support, design-time support, and manageability support (both WMI and group policy). The default is True. This attribute is optional.

Warn If No Category Match

Specifies whether events should be sent to the errors special source trace listener if a log entry contains a category that is not specified in configuration. Possible values are True and False. The default is True. This is optional.

Remarks

Performance testing has demonstrated a 5% performance overhead when reverting impersonation when logging using the rolling flat file trace listener.


Note:
For an ASP.NET site that uses the Logging Application Block, when Revert Impersonation is set to True, the credentials used to send an e-mail will be those of the ASP.NET worker process.