System.Composition.Convention
9.0.0
Prefix Reserved
dotnet add package System.Composition.Convention --version 9.0.0
NuGet\Install-Package System.Composition.Convention -Version 9.0.0
<PackageReference Include="System.Composition.Convention" Version="9.0.0" />
paket add System.Composition.Convention --version 9.0.0
#r "nuget: System.Composition.Convention, 9.0.0"
// Install System.Composition.Convention as a Cake Addin #addin nuget:?package=System.Composition.Convention&version=9.0.0 // Install System.Composition.Convention as a Cake Tool #tool nuget:?package=System.Composition.Convention&version=9.0.0
About
System.Composition.Convention
is part of the Managed Extensibility Framework (MEF) 2.0, a composition library for .NET that enables dependency injection through attributes or conventions.
This package simplifies the process of applying consistent patterns for part exports, imports, and metadata by using convention-based configurations. It is useful for scenarios where you want to avoid repetitive attribute-based decoration and instead define conventions for registering types in your composition container.
Key Features
- Configure exports, imports, and metadata for parts using conventions rather than attributes.
- Allows defining conventions through a fluent API, making configuration more flexible and readable.
How to Use
Configure parts for composition without using attributes.
using System.Composition.Convention;
using System.Composition.Hosting;
var conventions = new ConventionBuilder();
// Apply conventions: any class that implements ILogger will be exported as ILogger
conventions
.ForTypesDerivedFrom<ILogger>()
.Export<ILogger>();
var configuration = new ContainerConfiguration()
.WithPart<FileLogger>(conventions)
.WithPart<ConsoleLogger>(conventions);
using CompositionHost container = configuration.CreateContainer();
var loggers = container.GetExports<ILogger>();
foreach (var logger in loggers)
{
logger.Log("Hello, World!");
}
// FileLogger: Hello, World!
// ConsoleLogger: Hello, World!
public interface ILogger
{
void Log(string message);
}
public class FileLogger : ILogger
{
public void Log(string message) => Console.WriteLine($"FileLogger: {message}");
}
public class ConsoleLogger : ILogger
{
public void Log(string message) => Console.WriteLine($"ConsoleLogger: {message}");
}
Main Types
The main types provided by this library are:
System.Composition.Convention.ConventionBuilder
System.Composition.Convention.PartConventionBuilder
System.Composition.Convention.ParameterImportConventionBuilder
Additional Documentation
Related Packages
- System.Composition
- System.Composition.AttributedModel
- System.Composition.Hosting
- System.Composition.Runtime
- System.Composition.TypedParts
Feedback & Contributing
System.Composition.Convention is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- System.Composition.AttributedModel (>= 9.0.0)
-
.NETStandard 2.0
- System.Composition.AttributedModel (>= 9.0.0)
-
net8.0
- System.Composition.AttributedModel (>= 9.0.0)
-
net9.0
- System.Composition.AttributedModel (>= 9.0.0)
NuGet packages (35)
Showing the top 5 NuGet packages that depend on System.Composition.Convention:
Package | Downloads |
---|---|
System.Composition
Provides a version of the Managed Extensibility Framework (MEF) that is lightweight and specifically optimized for high throughput scenarios, such as the web. |
|
Microsoft.VisualStudio.Utilities
A member of the Visual Studio SDK |
|
Microsoft.VisualStudio.Shell.Framework
A member of the Visual Studio SDK |
|
Microsoft.VisualStudio.Imaging
A member of the Visual Studio SDK |
|
Microsoft.VisualStudio.Shell.15.0
A member of the Visual Studio SDK |
GitHub repositories (20)
Showing the top 5 popular GitHub repositories that depend on System.Composition.Convention:
Repository | Stars |
---|---|
neuecc/Utf8Json
Definitely Fastest and Zero Allocation JSON Serializer for C#(NET, .NET Core, Unity, Xamarin).
|
|
security-code-scan/security-code-scan
Vulnerability Patterns Detector for C# and VB.NET
|
|
icsharpcode/RefactoringEssentials
Refactoring Essentials for Visual Studio
|
|
chummer5a/chummer5a
Character generator for Shadowrun 5th edition
|
|
dotnet/dotnet
Home of .NET's Virtual Monolithic Repository which includes all the code needed to build the .NET SDK from source
|