PostSharp.Patterns.Diagnostics.Custom Namespace

This namespace contains the implementation of the custom logging front-end API. It is generally not needed in user code. It is normally not necessary to reference this namespace in user code, as the use of the var keyword is recommended.

Classes

	Class	Description
	InvalidFormattingStringException	Exception thrown by the FormattingStringParser and by the Logger class when user code provides an invalid formatting string.
	LegacySourceLogger	A base class for implementations of ILogger that cannot depend on the PostSharp.Patterns.Diagnostics package.
	LogEventMetadata	Defines how the raw CLR object stored in a LogEventData is translated into a set of visitable properties and an expression that is accessible from the transaction policy expressions.
	LogEventMetadata<TExpressionModel>	A specialization of LogEventMetadata that specifies the type of the expression model type, i.e. the type exposed to transaction policy expressions.
	LoggingPropertyOptionsAttribute	Specifies the options (LoggingPropertyOptions) of a logging property that is expresses as a public property of a CLR type.
	LogLevelSource	A facade to a LogSource constrained to a specific LogLevel. Instances of the LogLevelSource class are exposed as properties of the LogSource class, e.g. Debug or Error.

Structures

	Structure	Description
	CustomLogParameterOptions	Options of the WriteCustomParameter<T>(Int32, CharSpan, T, CustomLogParameterOptions) method.
	CustomLogRecordOptions	Options of the BeginWriteItem(CustomLogRecordItem, CustomLogRecordTextOptions) method.
	CustomLogRecordTextOptions	Options of the BeginWriteItem(CustomLogRecordItem, CustomLogRecordTextOptions) method.
	FormattingStringParser	Parses the formatting string for custom messages of the Logger and LogActivity classes.
	LogEventData	Specifies the properties of a log event (such as a message, an activity opening or an activity closing). Properties are typically passed in user code as an instance of an anonymous type. Any object can be provided. The properties of the message then stem from the properties of the CLR object. To change the logic that maps the CLR object to the list of property, you can specify a LogEventMetadata.
	LoggingPropertiesExpressionModel	Type of the t parameters for if and sample expressions in the policy configuration file.
	LoggingPropertyOptions	Specifies the behavior of logging properties (exposed by LogEventData), such as IsRendered, IsInherited or IsBaggage.
	LoggingPropertyVisitorOptions	Determines the behavior of the VisitProperties<TVisitorState>(ILoggingPropertyVisitor<TVisitorState>, TVisitorState, LoggingPropertyVisitorOptions) method.

Interfaces

	Interface	Description
	IContextLocalLogger	Abstraction of custom logging methods where the contact has already been resolved.
	ICustomLogRecordBuilder	Allows to build a custom log record (typically, but not necessarily, a string). A log record can be composed of one of several items.
	ILogActivityOptions	Exposes the default verbosity of the Logger and LogActivity classes when creating and closing activities.
	ILogger	Abstraction of the Logging facility, through which other components emit their log records. This interfaces abstracts other PostSharp components from the PostSharp.Patterns.Diagnostics component.
	ILogger2	Extends ILogger.
	ILogger3	Extends ILogger2.
	ILoggerExceptionHandler	Defines methods called in case of exception in the Logger class. This interface can be implemented by any class implementing the ILogger interface. When an ILogger does not implement this interface, logging exceptions are simply silently ignored.
	ILoggerFactory	Obsolete. Creates instances of the ILogger interface. An instance of this interface must be registered into the ServiceLocator.
	ILoggerFactory2	Obsolete. Creates instances of the ILogger2 interface.
	ILoggerFactory3	Creates instances of the ILogger2 interface based on names rather than types, in addition to based on types.
	ILoggerFactoryProvider	Obsolete. Creates instances of ILoggerFactory2. An instance of this interface must be registered into the ServiceLocator.
	ILoggerFactoryProvider3	A new version of ILoggerFactoryProvider that also provides a logger factory that can create loggers based on names rather than based on a type.
	ILoggingPropertyVisitor<TState>	Defines a Visit<TValue>(String, TValue, LoggingPropertyOptions, TState) method invoked for each property of a LogEventData.

Enumerations

	Enumeration	Description
	CustomLogParameterMode	Determines how a parameter of a custom record should be rendered by the WriteCustomParameter<T>(Int32, CharSpan, T, CustomLogParameterOptions) method.
	CustomLogRecordAttributes	Attributes of the CustomLogParameterOptions class. Describes how the ICustomLogRecordBuilder will be used.
	CustomLogRecordItem	Enumerates the situations in which an IMessage can be rendered.