PostSharp accepts several configuration settings such as the version and processor architecture of the CLR that is used at build time, the search path of dependencies, and whether some features are enabled.
Although the default configuration is appropriate for most situations, you may have to fine-tune some of them to cope with particular cases.
This article describes how to configure the settings in Visual Studio. You can also edit the MSBuild properties directly in a text editor. For details, see Configuring Projects Using MSBuild.
Note
Starting from Visual Studio 2022, the project properties tab is no longer available for SDK-style projects. Instead, you should edit the MSBuild properties using the text editor.
Editing properties in Visual Studio
Opening the PostSharp project property page in Visual Studio
Open the Solution Explorer.
Right-click the project, and then select Properties at the bottom of the menu.
Select the PostSharp tab.
Explanation of configuration settings
Note that all settings depend on the selected project configuration (for instance Debug) and platform (for instance Any CPU).
| Setting | MSBuild property name | Description |
|---|---|---|
| Disable PostSharp | SkipPostSharp |
True if PostSharp should not execute for the selected configuration and platform, otherwise False. |
| Additional search path | PostSharpSearchPath |
A semicolon-separated list of directories where plug-ins and libraries have to be searched for. This property can reference other MSBuild properties, for instance: ..\MyWeaver\bin\$(Configuration). All project references are already added to the search path by default. |
| Additional properties | PostSharpProperties |
A semicolon-separated list of property definitions, for instance: Name1=Value1;Name2=Value2. This property can reference other MSBuild properties, for instance: RootNamespace=$(RootNamespace). Several properties are defined by default; for details, see Well-Known PostSharp Properties. |
| Suppress warnings | PostSharpDisabledMessages |
A semicolon-separated list of warning identifiers that must be ignored. The * wildcard is not supported here; it is supported only to escalate warnings. |
| Treat warnings as errors | PostSharpEscalatedMessages |
A semicolon-separated list of warning identifiers that must be escalated into errors, or * if all warnings must be treated as errors. |
| Architecture Validation | PostSharpConstraintVerificationEnabled |
True if constraints must be validated, otherwise False. The default value is True. For details regarding architecture validation, see Validating Architecture. |
| CLR Version | PostSharpTargetFrameworkVersion |
The version of the CLR that hosts PostSharp. PostSharp currently supports only CLR 4.0, so this setting is disabled. |
| Processor Architecture | PostSharpTargetProcessor |
The processor architecture (x86, x64 or arm64) of the process hosting PostSharp. Since PostSharp needs to execute the current project during the build, the processor architecture of the PostSharp process must be compatible with the target platform of the current project. By default, PostSharp uses the target platform of the current project. If the project targets AnyCPU, PostSharp uses the architecture of the operating system. |
| Build Host | PostSharpHost |
The kind of process hosting PostSharp, which influences the assembly loading mechanism, compatibility and performance features. See Hosting properties. |
| Optimization Mode | PostSharpOptimizationMode |
When set to Build Time, PostSharp will use a faster algorithm to generate the final assembly. When set to Size, PostSharp will use a slower algorithm that generates smaller assemblies. The default value is Build Time, or Size when the C# or VB compiler is set to generate optimal code (typically, in release builds). |