PostSharp – Release Notes

Cache values with default configuration will not be compatible across version. If compatibility with old values is required, Serializer should be changed to BinarySerializer. Minimum supported .NETFramework version of PostSharp.Patterns.Caching was increased to v4.6.1.

AzureCacheInvalidator and AzureCacheInvalidator2 depending on deprecated packages are now obsolete and will throw exceptions. Use AzureServiceBusCacheInvalidator instead. Minimum supported .NET Framework version of PostSharp.Patterns.Caching.Backends.Azure was increased to v4.7.1.

AnyCPU projects referencing x86-specific libraries may fail to load dependencies. PostSharpTargetProcessor should be set to a correct architecture.

[Serializable] should not be used on Aspects and is now deprecated. [PSerializable] should be used instead. The error can be suppressed using PostSharpBinaryFormatterAllowed=True.

SDKs older than .NET 6.0 are now incompatible with PostSharp. At the time of this change, all SDKs supported by Microsoft are also supported by PostSharp.

Package versions with security vulnerabilities are not supported by PostSharp packages anymore.

See 28010.

New methods in ILoggerFactory3 (very low impact).

LoggingTransaction.Open has been renamed TryOpen and its signature has changed. (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.