Logging Application Block 4.1 配置参考

迷南。 2021-12-14 08:11 201阅读 0赞

有点搞不懂Logging Application Block中的一些配置项目，找了说明书上的参考。

参照网上的说法，简单说明一下。

1、Filters:设定过滤器，可设置那些日志会被记录下来，可以按日志分类，优先级，自定义日志过滤条件。  
2、Category Source:按分类设定该分类的消息**（通过Trace Listener）**记录到的目标位置，如你可以设置A分类记录在数据库，而B分类记录在文本文件；  
3、Special Source:根据日志的事件类型，来指定日志记录的目标位置，如你可以将错误&警告信息记录在数据库，其它的事件类型的日志记录在系统日志；**与Category的SourceLevels有关，与LogEntry的Severity无关，LogEntry只是信息数据的载体；**  
4、Trace Listeners:Enterprise Library 4.1 提供了10种Trace Listeners，分别用于将日志信息记录到不同目的地中，可以记录至文本文件，事件日志，Email，XML文档，数据库，Msmq消息队列，windows的事件日志等;  
5、Formatters:它用于指定日志信息的格式，有三种格式：Text，Custom，Binary；

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

The tables in this topic explain the Logging Application Block properties. This topic includes the following sections:

*  [Trace Listener Properties][]
 *  [Category Source Properties][]
 *  [Filter Properties][]
 *  [Logging Application Block Properties][]

# Trace Listener Properties #

![spacer.gif][]

These tables explain the properties for the different trace listeners. There are tables for the following trace listeners:

*  [Custom Trace Listener][]. This is a class you have created that derives from the **CustomTraceListener** class.
 *  [Database Trace Listener][]. This trace listener writes formatted log entries to a database.
 *  [Email Trace Listener][]. This trace listener sends log entries as e-mail messages.
 *  [Flat File Trace Listener][]. This trace listener writes log entries to a text file.
 *  [Formatted Event Log Trace Listener][]. This trace listener formats log entries and writes them to Windows Event Log.
 *  [MSMQ Trace Listener][]. This trace listener writes log entries to a message queue.
 *  [Rolling Flat File Trace Listener][]. This trace listener creates a new log file depending on the current log file age and/or size.
 *  [System Diagnostics Trace Listener][]. This is one of the .NET Framework trace listeners such as the Console Trace Listener.
 *  [WMI Trace Listener][]. This trace listener raises a WMI management event for each log entry received.
 *  [XML Trace Listener][]. This trace listener is used to integrate the Logging Application Block with applications that use WCF.

For more information, see the [TraceOutputOptions][] Values table.

![spacer.gif][] ![spacer.gif][]

# Custom Trace Listener #

The following table lists the properties that you can set when you add a custom trace listener to the configuration.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Attributes</td> 
 <td> The key/value pairs. To edit these, click the ellipsis button (…) and use the EditableKeyValue Collection Editor. The attributes are a collection of key/value string pairs of configuration information for the custom trace listener.</td> 
 </tr> 
 <tr> 
 <td> Formatter</td> 
 <td> The formatter to use with this trace listener. Click the formatter you want to use in the drop-down list. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the trace listener. The default is Custom Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td><img height="1" alt="" src="/images/20211214/ce42f38aa894471485b0c359d0034ad1.png" width="1">Trace listeners use this property to determine which options, or elements, should be included in the trace output. Possible values are: CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, a Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Type</td> 
 <td> The type of the trace listener. The type must derive from the CustomTraceListener class. Click the ellipsis button (…) to view the Type Selector dialog box, and then click the type you want. This is required.</td> 
 </tr> 
 </tbody> 
</table>

![spacer.gif][] ![spacer.gif][]

# Database Trace Listener #

The following table lists the properties that you can set when you add a **Database TraceListener**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> AddCategoryStoredProcedure</td> 
 <td> The name of the stored procedure that adds a category. The default is AddCategory. This is required.</td> 
 </tr> 
 <tr> 
 <td> DatabaseInstance</td> 
 <td> The name of the database instance to use. The default is None. This is required.</td> 
 </tr> 
 <tr> 
 <td> Filter</td> 
 <td> Applies a filter that selects the level of message that it will detect. The valid values are All (the default), Off, Critical, Error, Warning, Information, Verbose, and Activity Tracing. The setting effectively means "the specified level and everything more important." For example, the Warning setting will detect warnings, errors, and critical events.</td> 
 </tr> 
 <tr> 
 <td> Formatter</td> 
 <td> The formatter to use with this trace listener. Select one from the drop-down list. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the trace listener. The default is Database Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td><img height="1" alt="" src="/images/20211214/ce42f38aa894471485b0c359d0034ad1.png" width="1">A property used by trace listeners to determine which options, or elements, should be included in the trace output. Possible values are CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, and Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 <tr> 
 <td> WriteLogStoredProcedureName</td> 
 <td> The name of the stored procedure that writes the log entries. The default is WriteLog. This is required.</td> 
 </tr> 
 </tbody> 
</table>

![spacer.gif][] ![spacer.gif][]

# Email Trace Listener #

The following table lists the properties that you can set when you add an **Email TraceListener**.

![spacer.gif][] ![spacer.gif][]

# Flat File Trace Listener #

The following table lists the properties that you can set when you add a **Flat****F****ile TraceListener**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Filename</td> 
 <td> The name of the file where entries are written. The default name is trace.log. This is a required value. It can include environment variables such as %WINDIR%, %TEMP%, and %USERPROFILE%.</td> 
 </tr> 
 <tr> 
 <td> Filter</td> 
 <td> Applies a filter that selects the level of message that it will detect. The valid values are All (the default), Off, Critical, Error, Warning, Information, Verbose, and Activity Tracing. The setting effectively means "the specified level and everything more important." For example, the Warning setting will detect warnings, errors, and critical events.</td> 
 </tr> 
 <tr> 
 <td> Footer</td> 
 <td> Additional information contained in the file footer. The default is "----------------------------------------." This is optional.</td> 
 </tr> 
 <tr> 
 <td> Formatter</td> 
 <td> The formatter to use with this trace listener. Select one from the drop-down list. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Header</td> 
 <td> Additional information contained in the file header. The default is "----------------------------------------." This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the trace listener. The default is FlatFile Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td> Trace listeners use this property to determine which options, or elements, should be included in the trace output. Possible values are: CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, a Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
 <tr> 
 <th align="left"><img alt="" src="https://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/local/note.gif">Note:</th> 
 </tr> 
 <tr> 
 <td>If the file you specify for the FlatfileTraceListener is read-only, the trace listener does not write the data to the file and no exception occurs. Make sure that the file attributes are set to read/write. When you use the FlatFileTraceListener class to write log information to a file, the application block locks the file until the application closes. It is possible to open and read the file, but you cannot move or delete the log file until you close the application.</td> 
 </tr> 
 </tbody> 
</table>

![spacer.gif][] ![spacer.gif][]

# Formatted Event Log Trace Listener #

The following table lists the properties that you can set when you add a **Formatted EventLog TraceListener**.

![spacer.gif][] ![spacer.gif][]

# MSMQ Trace Listener #

The following table lists the properties that you can set when you add an **Msmq TraceListener**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Filter</td> 
 <td> Applies a filter that selects the level of message that it will detect. The valid values are All (the default), Off, Critical, Error, Warning, Information, Verbose, and Activity Tracing. The setting effectively means "the specified level and everything more important." For example, the Warning setting will detect warnings, errors, and critical events.</td> 
 </tr> 
 <tr> 
 <td> Formatter</td> 
 <td> The formatter to use with this trace listener. Select one from the drop-down list. This must be the Binary Formatter when you use this listener with the Message Queuing distributor service. This is optional.</td> 
 </tr> 
 <tr> 
 <td> MessagePriority</td> 
 <td> Sets the priority of a log entry. This determines its priority while the log entry is in transit and when it is inserted into its destination queue. Possible values are AboveNormal, High, Highest, Low, Lowest, Normal, VeryHigh, and VeryLow. It applies to the MsmqTraceListener class. The default is Normal. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the trace listener. The default is Msmq Trace Listener.</td> 
 </tr> 
 <tr> 
 <td> QueuePath</td> 
 <td> The path to the queue that the Msmq TraceListener instance uses. This attribute is a message queuing path, and it applies to the MsmqTraceListener class. The default is .\Private$\myQueue. This is required.</td> 
 </tr> 
 <tr> 
 <td> Recoverable</td> 
 <td> Specifies whether the log entry is guaranteed to be delivered if there is a computer failure or network problem. The default is False. This is optional.</td> 
 </tr> 
 <tr> 
 <td> TimeToBeReceived</td> 
 <td> The total time for a log entry to be received by the destination queue. The default is 49710.06:28:15. This is optional.</td> 
 </tr> 
 <tr> 
 <td> TimeToReachQueue</td> 
 <td> The maximum time for the log entry to reach the queue. The default is 49710.06:28:15. This is optional.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td> Attaches additional information to platform-provided trace listener output. Possible values are CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, and Timestamp. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> TransactionType</td> 
 <td> The type of a Message Queuing transaction. Possible values are Automatic, None, and Single. It applies to the MsmqTraceListener class. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> UseAuthentication</td> 
 <td> Specifies whether the message was (or must be) authenticated before being sent. The default is False. This is optional.</td> 
 </tr> 
 <tr> 
 <td> UseDeadLetterQueue</td> 
 <td> Specifies whether a copy of a message that could not be delivered should be sent to a dead-letter queue. The default is False. This is optional.</td> 
 </tr> 
 <tr> 
 <td> UseEncryption</td> 
 <td> Specifies whether to make the message private. The default is False. This is optional.</td> 
 </tr> 
 </tbody> 
</table>

![spacer.gif][] ![spacer.gif][] ![spacer.gif][]

# Rolling Flat File Trace Listener #

The following table lists the properties that you can set when you add a **Rolling Flat File Trace Listener**. This trace listener allows you to control the size and age of a log file.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> FileName</td> 
 <td> This is the name of the rolling flat file. This is a required value. It can include environment variables such as %WINDIR%, %TEMP%, and %USERPROFILE%.</td> 
 </tr> 
 <tr> 
 <td> Filter</td> 
 <td> Applies a filter that selects the level of message that it will detect. The valid values are All (the default), Off, Critical, Error, Warning, Information, Verbose, and Activity Tracing. The setting effectively means "the specified level and everything more important." For example, the Warning setting will detect warnings, errors, and critical events.</td> 
 </tr> 
 <tr> 
 <td> Footer</td> 
 <td> Additional information contained in the file footer. The default is "----------------------------------------." This is optional.</td> 
 </tr> 
 <tr> 
 <td> Formatter</td> 
 <td> The formatter to use with this trace listener. Select one from the drop-down list. The default is None. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Header</td> 
 <td> Additional information contained in the file header. The default is "----------------------------------------." This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> This is the name of the trace listener. The default is Rolling Flat File Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> RollFileExistsBehavior</td> 
 <td> This property determines what occurs to an existing file when it rolls over. If you select Overwrite, the existing file is overwritten. If you select Increment, the application block creates a new file and names it by incrementing the timestamp.</td> 
 </tr> 
 <tr> 
 <td> RollInterval</td> 
 <td> This property determines when the log file rolls over. You can select None (the default), Midnight (in which case the log will roll over at midnight), Minute, Hour, Day, Month, or Year. This is optional.</td> 
 </tr> 
 <tr> 
 <td> RollSizeKB</td> 
 <td> This is the maximum size the file can reach, in kilobytes, before it rolls over. This is optional.</td> 
 </tr> 
 <tr> 
 <td> TimeStampPattern</td> 
 <td> This is the date/time format that is appended to the new file name (see the Remarks section that follows this table). This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td> Trace listeners use this property to determine which options, or elements, should be included in the trace output. Possible values are: CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, and Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 </tbody> 
</table>

![spacer.gif][]

## Remarks ##

*  You can control either or both the size of the file and/or its age. For example, if you specify in configuration a **RollSizeKB** value of 5 KB and a **RollInterval** value of Day, the file rolls when its size exceeds 5 KB and it also rolls at the end of the day.
 *  If you select **Increment** for the **RoleFileExistsBehavior**, the application block creates a new file when the existing file rolls over. The file name includes the current timestamp. If a file with this name already exists, the application block adds an integer to the end of the timestamp and increments it until it cannot find a file with that name. For example, assume there is a file named **mylog2007-01-1****0****.log** and the file rolls over while that timestamp is still valid. The application block will then look for a file named **mylog2007-01-1****0****.1.log**. If no such file exists, it will use that file name for the new file. If that file also exists, it will then attempt to locate the log with the next sequence number **mylog2007-01-1****0****.2.log**.
 *  If you select **Overwrite** for the **RoleFileExistsBehavior**, the application block creates a new file when the current file rolls over. The name of the file includes the current timestamp. If a file with that name already exists, the application block overwrites the file. If, for some reason, it cannot overwrite the file, it will generate a name using the same process that is used with the **Increment** value.
 *  Relative path names resolve to a location that is relative to the *AppDomain.CurrentDomain.BaseDirectory* directory.

![spacer.gif][] ![spacer.gif][]

# System.Diagnostics TraceListener #

The **TraceListener** class provides the **abstract** base class for trace listeners that monitor trace and debug output. The following table lists the properties that appear when you add a **System.Diagnostics****TraceListener**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> InitData</td> 
 <td> If supplied, this property is used when the application block constructs a trace listener. It is a string whose meaning depends on the type of trace listener being constructed. For the .NET Framework trace listeners, the string has the following values: TextWriterTraceListener: filename; XmlWriterListener: filename; DelimitedLIstTraceListener: filename; ConsoleTraceListener: not applicable; DefaultTraceListener: not applicable; EventLogTraceListener: event source name. If the InitData field is not specified, the application block uses the default constructor. If the user specifies the InitData field for a trace listener that does not have a constructor overload that accepts a string, an error occurs. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the trace listener. The default is System.Diagnostics Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td> Trace listeners use this property to determine which options, or elements, should be included in the trace output. Possible values are: CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, a Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Type</td> 
 <td> The type of the trace listener. Select from the drop-down list. This is required.</td> 
 </tr> 
 </tbody> 
</table>

# WMI Trace Listener #

The WMI Trace Listeneris atrace listener that raises a WMI management event for each log entry it receives. The following table lists the properties that you can set when you add a **WMI TraceListener**.

# XML Trace Listener #

The following table lists the properties that you can set when you add an **XML TraceListener**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> FileName</td> 
 <td> This is the name of the file where the trace listener writes the data it extracts from an XmlLogEntry object. This is a required value. It can include environment variables such as %WINDIR%, %TEMP%, and %USERPROFILE%.</td> 
 </tr> 
 <tr> 
 <td> Filter</td> 
 <td> Applies a filter that selects the level of message that it will detect. The valid values are All (the default), Off, Critical, Error, Warning, Information, Verbose, and Activity Tracing. The setting effectively means "the specified level and everything more important." For example, the Warning setting will detect warnings, errors, and critical events.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> This is the name of the trace listener. The default is XML Trace Listener. This is required.</td> 
 </tr> 
 <tr> 
 <td> TraceOutputOptions</td> 
 <td> Trace listeners use this property to determine which options, or elements, should be included in the trace output. Possible values are: CallStack, DateTime, LogicalOperationStack, None, ProcessId, ThreadId, a Timestamp. The default is None. For an explanation of these values, see the TraceOutputOptions Values table. This is optional.</td> 
 </tr> 
 </tbody> 
</table>

# TraceOutputOptions Values #

The following table lists the possible **TraceOutputOptions** values.

<table> 
 <tbody> 
 <tr> 
 <th> Value</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> CallStack</td> 
 <td> Write the call stack, which is represented by the return value of the <a href="http://msdn2.microsoft.com/en-us/library/system.environment.stacktrace.aspx" rel="nofollow">Environment.StackTrace</a> property.</td> 
 </tr> 
 <tr> 
 <td> DateTime</td> 
 <td> Write the date and time.</td> 
 </tr> 
 <tr> 
 <td> LogicalOperationsStack</td> 
 <td> Write the logical operation stack, which is represented by the return value of the <a href="http://msdn2.microsoft.com/en-us/library/system.diagnostics.correlationmanager.logicaloperationstack.aspx" rel="nofollow">CorrelationManager.LogicalOperationStack</a> property.</td> 
 </tr> 
 <tr> 
 <td> None</td> 
 <td> Do not write any elements.</td> 
 </tr> 
 <tr> 
 <td> ProcessId</td> 
 <td> Write the process identity, which is represented by the return value of the <a href="http://msdn2.microsoft.com/en-us/library/system.diagnostics.process.id.aspx" rel="nofollow">Process.ID</a> property.</td> 
 </tr> 
 <tr> 
 <td> ThreadId</td> 
 <td> Write the ThreadIdentity, which is represented by the return value of the <a href="http://msdn2.microsoft.com/en-us/library/system.threading.thread.managedthreadid.aspx" rel="nofollow">Thread.ManagedThreadIdProperty</a> for the current thread.</td> 
 </tr> 
 <tr> 
 <td> Timestamp</td> 
 <td> Write the timestamp, which is represented by the return value of the <a href="http://msdn2.microsoft.com/en-us/library/system.diagnostics.stopwatch.gettimestamp.aspx" rel="nofollow">System.Diagnostics.Stopwatch.GetTimeStamp</a> method.</td> 
 </tr> 
 </tbody> 
</table>

# ![Collapse image][]Category Source Properties #

The following table lists the **Category Source** properties.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the category. The default is Category Source.</td> 
 </tr> 
 <tr> 
 <td> SourceLevels</td> 
 <td> Possible values are ActivityTracing, All, Critical, Error, Information, Off, Verbose, and Warning. The default is All. See the following table for more information.</td> 
 </tr> 
 <tr> 
 <td> AutoFlush</td> 
 <td> Specifies whether the listener will flush its data to the target after every new entry is written to this source. The default value is True. When set to False, code can flush the entries when required. Note that it is your responsibility to ensure that all entries are flushed to the target, especially if an exception or failure occurs in the application. Otherwise, you will lose any cached logging information not yet written to the target.</td> 
 </tr> 
 </tbody> 
</table>

# SourceLevels Values #

The following table lists the possible **SourceLevels** values for a category.

<table> 
 <tbody> 
 <tr> 
 <th> Value</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> ActivityTracing</td> 
 <td> Allows the Stop, Start, Suspend, Transfer, and Resume events through.</td> 
 </tr> 
 <tr> 
 <td> All</td> 
 <td> Allows all events through.</td> 
 </tr> 
 <tr> 
 <td> Critical</td> 
 <td> Allows only Critical events through. A critical event is a fatal error or application crash.</td> 
 </tr> 
 <tr> 
 <td> Error</td> 
 <td> Allows Critical and Error events through. An Error event is a recoverable error.</td> 
 </tr> 
 <tr> 
 <td> Information</td> 
 <td> Allows Critical, Error, Warning, and Information events through. An information event is an informational message.</td> 
 </tr> 
 <tr> 
 <td> Off</td> 
 <td> Does not allow any events through.</td> 
 </tr> 
 <tr> 
 <td> Verbose</td> 
 <td> Allows Critical, Error, Warning, Information, and Verbose events through. A Verbose event is a debugging trace.</td> 
 </tr> 
 <tr> 
 <td> Warning</td> 
 <td> Allows Critical, Error, and Warning events through. A Warning event is a non-critical problem.</td> 
 </tr> 
 </tbody> 
</table>

# ![Collapse image][]Filter Properties #

The following tables explain the properties for the different types of filters. There are tables for the following filters:

*  [Category Filter][]. This allows or denies log entries based on their categories.
 *  [LogEnabled Filter][]. This either enables or disables logging.
 *  [Priority Filter][]. This allows or denies log entries based on their priorities.
 *  [Custom Filter][]. This is a filter that you have added to the Logging Application Block.

# Category Filter #

The following table lists the properties that appear when you add a **Category****Filter**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> CategoryFilterExpression</td> 
 <td> Sets up the rule for denying or allowing the specified categories. Use the Category Filter Editor to configure the expression.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the filter. The default is Category Filter.</td> 
 </tr> 
 </tbody> 
</table>

# LogEnabled Filter #

The following table lists the properties that appear when you add a **LogEnabled Filter**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Enabled</td> 
 <td> The filter is enabled when this property value is True. The default is False.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the filter. The default is LogEnabled Filter.</td> 
 </tr> 
 </tbody> 
</table>

# Priority Filter #

The following table lists the properties that appear when you add a **Priority Filter**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> MaximumPriority</td> 
 <td> The maximum value a log entry can have to be logged. If you do not set this property, there is no maximum value.</td> 
 </tr> 
 <tr> 
 <td> MinimumPriority</td> 
 <td> The minimum value a log entry must have to be logged. If you do not set this property, there is no minimum value. The default is -1.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the filter. The default is Priority Filter.</td> 
 </tr> 
 </tbody> 
</table>

# Custom Filter #

The following table lists the properties that appear when you add a **Custom****Filter**.

<table> 
 <tbody> 
 <tr> 
 <th> Property</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> Attributes</td> 
 <td> The key/value pairs for this filter. Click the ellipsis button (…) and use the EditableKeyValue Collection Editor.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name of the filter. The default is Custom Filter.</td> 
 </tr> 
 <tr> 
 <td> Type</td> 
 <td> The type of the trace listener. Select one from the drop-down list. This is required.</td> 
 </tr> 
 </tbody> 
</table>

# ![Collapse image][]Logging Application Block Properties #

The following table lists the properties that appear in the **General** section when you add the Logging Application Block.

<table> 
 <tbody> 
 <tr> 
 <th> Attribute</th> 
 <th> Description</th> 
 </tr> 
 <tr> 
 <td> DefaultCategory</td> 
 <td> Log entries go to this category if no other category is specified. The default is General. This is required.</td> 
 </tr> 
 <tr> 
 <td> LogWarningsWhenNoCategoriesMatch</td> 
 <td> 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 or false. The default is false. This is optional.</td> 
 </tr> 
 <tr> 
 <td> Name</td> 
 <td> The name is Logging Application Block. This is required.</td> 
 </tr> 
 <tr> 
 <td> RevertImpersonation</td> 
 <td> 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.</td> 
 </tr> 
 <tr> 
 <td> TracingEnabled</td> 
 <td> Specifies whether activity tracing is enabled. Possible values are True or False</td> 
 </tr> 
 </tbody> 
</table>

转载于:https://www.cnblogs.com/staticlight/archive/2010/01/16/1649719.html

[Trace Listener Properties]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#props_tracelistener
[Category Source Properties]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#props_categorysources
[Filter Properties]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#props_filters
[Logging Application Block Properties]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#props_appblock
[spacer.gif]: /images/20211214/ce42f38aa894471485b0c359d0034ad1.png
[Custom Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_custom
[Database Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_database
[Email Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_email
[Flat File Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_flatfile
[Formatted Event Log Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_eventlog
[MSMQ Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_msmq
[Rolling Flat File Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_rolling
[System Diagnostics Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_system
[WMI Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_wmi
[XML Trace Listener]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_xml
[TraceOutputOptions]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#trace_optionsvalues
[Collapse image]: /images/20211214/9d2f653d919e4b6591e491ab5b82e686.png
[Category Filter]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#filter_category
[LogEnabled Filter]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#filter_logenabled
[Priority Filter]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#filter_priority
[Custom Filter]: http://www.cnblogs.com/staticlight/admin/ms-help://MS.VSCC.v90/MS.VSIPCC.v90/ms.practices.entlib.2008oct/EntLibDocs2008Oct/html/EntLib2008Oct_8a8fe362-fc76-49df-bef5-f1dd9e592a1a.html#filter_custom