PostSharp – Release Notes

LoggingTransaction.Open has been renamed TryOpen and its signature has changed. (very low impact)

See 28010.

New methods in ILoggerFactory3 (very low impact).

Indentation of async methods in logging is no longer based on the execution context but rather on the thread context. This improves performance. The property ParentContext on logging context now always refers to the thread context.

The PostSharp Serilog backend now requires Serilog 2.3.0 at least, and .NET Framework 4.5.0 at least.

Read-only fields and getter-only properties in classes with a Threading model are now protected by the threading model.

Previously, a [Command] property where an Execute method could not be found did nothing. Now, this will emit an error.

Previously, if you had two PostSharp configuration files with the same filename, only one was loaded. Now, all of them are loaded.

MulticastAttributes.Instance and MulticastAttributes.Static are no longer ignored in AttributeTargetTypeAttributes and TargetTypeAttributes.

It is now a build-time error to declare two attributes on the same element if their MulticastAttributeUsage.AllowMultiple is false. Previously, one of those attributes was silently removed.

The order of RuntimeInitialize() calls of two aspects on the same type may now be different. Also, some aspects weren't ordered correctly may now cause build errors. You can fix these build errors by using ordering those aspects.

It is now a build-time error to attempt to copy assembly-internal attributes using [CopyAttributes], or copying them implicitly on parameters, type parameters and return values using [IntroduceMember].

Renaming a FieldRef or a MemberRef using PostSharp.SDK now invalidates the enumerator on collections in TypeDef, TypeRef and TypeSpec classes.

Properties StateField, CurrentValueField and IsDisposingField now have subtly different meaning. They're not meant to be used by PostSharp users.

Auto-implemented properties changed into dependency properties with [DependencyProperty] no longer ignore their initializers.

OnSetValue will now intercept initializers of static auto-implemented properties. It will also now intercept writes to getter-only instance auto-implemented properties in the constructor. Writes by the initializer on the same line as the property declaration are still not intercepted, use the new OnInstanceLocationInitialized advice for that.

Previously, SemanticallyAdvisableMethodKinds.All incorrectly didn't include non-async method that return a Task.

Contracts written for validation of sbyte/short/int/long that used to accept the unsigned counterpart (and vice versa) will stop working. You will need to add logic for the alternative type.

Your build is going to fail if you have older version of .NET Core 2.1 SDK installed.

Your log output may look differently, and you may need to update your logger configuration.

Changes in the protected-visible API of TextLogRecordBuilder.

Changes in the ILogger interface. Logger now acts on the topmost context regardless of the LogActivity instance, if any.

PostSharpTrace class completely refactored and moved to namespace PostSharp.Extensibility.BuildTimeLogging.

LogActivity.SetException now returns bool instead of void.

PostSharp.Patterns.Diagnostics.dll: the class PostSharp.Patterns.Diagnostics.RecordBuilders.ParameterDirection is replaced by PostSharp.Reflection.ParameterDirection (possibly breaking if you implemented your custom back-end).

This is a once-in-5-years refactoring and therefore we may have broken things. There are important changes if you build using the command line.

Changes in IMethodBodyVisitor, IBlockExpression, IExceptionHandler, MethodBodyElementKind,

Method PostSharp.Patterns.Diagnostics.TextLogRecordBuilder.AppendParameter has been renamed AppendSemanticParameter and has different signature.

Some semantic parameters (such as the method name and parameter name) are no longer transformed into Serilog semantic parameters by default but into plain text. See SerilogLoggingBackendOptions.SemanticParametersTreatedSemantically.

Metadata for the PostSharp-Patterns-Diagnostics event source has changed.