Release 1.0 - ...
<loggingConfiguration> element
Configures the listeners, formatter(s), categorySources and specialSources.
The listeners element is used to configure one or more trace listeners, which can then be used within the categorySources and/or specialSources elements to configure routing of log messages of specific log types and/or categories to specific trace listeners.
The formatters element can be used to configure log entry formatters, which can then be used by a trace listener to format the log entry before it is written to its destination.
Example
| XML |
Copy Code
|
<loggingConfiguration name="Logging Application Block"
tracingEnabled="true" defaultCategory=""
logWarningsWhenNoCategoriesMatch="true">
<listeners>
<!-- add listeners (omitted) -->
</listeners>
<formatters>
<!-- add formatter(s) (omitted) -->
</formatters>
<categorySources>
<!-- add categorySources configuration (omitted) -->
</categorySources>
<specialSources>
<!-- add specialSources configuration (omitted) -->
</specialSources>
</loggingConfiguration>
|
Attributes
| Attribute name |
Required |
Description |
| name |
Yes |
Name of the configuration node, e.g. Logging Application Block. |
| tracingEnabled |
Yes |
Enables or disables trace logging. |
| defaultCategory |
Yes |
Can be used to specify a default category which should be used if the log entry to be written doesn't specify a category. This is a required attribute, but since the logging implementation within iXperion will always provide a category, this attribute can be left empty. |
| logWarningsWhenNoCategoriesMatch |
Yes |
Boolean which indicates if a warning should be logged when a non-matching category is encountered. If that's the case, the log entry is routed to the logging errors and warnings special log source (the errors element). |
Parent element
| Element name |
Description |
| <configuration> |
The root element for the Smartsite.Logging.config file. |
Child elements
| Element name |
Description |
| <listeners> |
Configures the listener(s), which will be available for log messages routing. |
| <formatters> |
Configures one or more formatters. |
| <specialSources> |
Configures routing of log entries to one or more specified trace listeners. |
| <categorySources> |
Configures routing of log entries of a specific logtype or category to one or more specified trace listeners. |
