Microsoft.Orleans.Core 10.0.0
Microsoft Orleans Core Library
Introduction
Microsoft Orleans Core is the primary library used by both client and server applications. It provides the runtime components necessary for Orleans applications, including serialization, communication, and the core hosting infrastructure.
Getting Started
To use this package, install it via NuGet:
dotnet add package Microsoft.Orleans.Core
This package is automatically included when you reference the Orleans SDK or the Orleans client/server metapackages.
Example - Configuring a Client
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Orleans;
using Orleans.Configuration;
using System;
using System.Threading.Tasks;
// Define a grain interface
namespace MyGrainNamespace;
public interface IHelloGrain : IGrainWithStringKey
{
Task<string> SayHello(string greeting);
}
// Implement the grain interface
public class HelloGrain : Grain, IHelloGrain
{
public Task<string> SayHello(string greeting)
{
return Task.FromResult($"Hello! I got: {greeting}");
}
}
// Create a client
var builder = Host.CreateApplicationBuilder(args)
.UseOrleansClient(client =>
{
client.UseLocalhostClustering();
});
var host = builder.Build();
await host.StartAsync();
// Get a reference to a grain and call it
var grain = host.Services.GetRequiredService<IClusterClient>().GetGrain<IHelloGrain>("grain-id");
var response = await grain.SayHello("Hello from client!");
// Print the result
Console.WriteLine($"Response: {response}");
// Keep the host running until the application is shut down
await host.WaitForShutdownAsync();
Documentation
For more comprehensive documentation, please refer to:
Feedback & Contributing
- If you have any issues or would like to provide feedback, please open an issue on GitHub
- Join our community on Discord
- Follow the @msftorleans Twitter account for Orleans announcements
- Contributions are welcome! Please review our contribution guidelines
- This project is licensed under the MIT license
Showing the top 20 packages that depend on Microsoft.Orleans.Core.
| Packages | Downloads |
|---|---|
|
Microsoft.Orleans.Runtime.Abstractions
Library with core types shared between silo and extensions.
|
2 |
|
Microsoft.Orleans.Runtime.Abstractions
Library with core types shared between silo and extensions.
|
1 |
|
Microsoft.Orleans.Sdk
Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
|
1 |
|
Microsoft.Orleans.Client
Referencing this package is necessary for a client to communicate with an Orleans system.
|
1 |
|
Microsoft.Orleans.Server
Referencing this package is necessary for a silo to start.
|
1 |
|
Microsoft.Orleans.Client
Collection of Microsoft Orleans libraries and files needed on the client.
|
1 |
.NET 8.0
- Microsoft.Orleans.Analyzers (>= 10.0.0)
- Microsoft.Orleans.CodeGenerator (>= 10.0.0)
- Microsoft.Orleans.Core.Abstractions (>= 10.0.0)
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.11)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyModel (>= 8.0.2)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 8.0.1)
- Microsoft.Extensions.ObjectPool (>= 8.0.22)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.4)
- System.Memory.Data (>= 8.0.1)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 4.5.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.5.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Json (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- Microsoft.Extensions.Logging.Console (>= 8.0.1)
- Microsoft.Extensions.Logging.Debug (>= 8.0.1)
- Microsoft.Extensions.Options (>= 8.0.2)
- System.IO.Hashing (>= 10.0.0)
- System.IO.Pipelines (>= 8.0.0)
.NET 10.0
- Microsoft.Orleans.Analyzers (>= 10.0.0)
- Microsoft.Orleans.CodeGenerator (>= 10.0.0)
- Microsoft.Orleans.Core.Abstractions (>= 10.0.0)
- Microsoft.AspNetCore.Connections.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.0)
- Microsoft.Extensions.DependencyModel (>= 10.0.0)
- Microsoft.Extensions.Hosting (>= 10.0.0)
- Microsoft.Extensions.Logging (>= 10.0.0)
- Microsoft.Extensions.ObjectPool (>= 10.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.0)
- Newtonsoft.Json (>= 13.0.4)
- System.Memory.Data (>= 10.0.0)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 5.0.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 5.0.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Configuration.Json (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Console (>= 10.0.0)
- Microsoft.Extensions.Logging.Debug (>= 10.0.0)
- Microsoft.Extensions.Options (>= 10.0.0)
- System.IO.Hashing (>= 10.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 10.0.0 | 1 | 01/27/2026 |
| 10.0.0-rc.2 | 0 | 12/31/2025 |
| 9.2.1 | 0 | 07/16/2025 |
| 9.2.0 | 0 | 07/14/2025 |
| 9.2.0-preview3 | 1 | 01/27/2026 |
| 9.2.0-preview2 | 0 | 06/04/2025 |
| 9.2.0-preview1 | 1 | 01/27/2026 |
| 9.1.2 | 1 | 01/27/2026 |
| 9.0.1 | 0 | 11/23/2024 |
| 9.0.0 | 0 | 11/14/2024 |
| 8.2.0 | 1 | 01/27/2026 |
| 8.2.0-preview1 | 0 | 05/22/2024 |
| 8.1.0 | 1 | 01/27/2026 |
| 8.1.0-preview3 | 1 | 01/27/2026 |
| 8.1.0-preview2 | 1 | 01/27/2026 |
| 8.1.0-preview1 | 1 | 01/27/2026 |
| 8.0.0 | 0 | 01/05/2024 |
| 8.0.0-rc2 | 0 | 12/20/2023 |
| 8.0.0-rc1 | 0 | 12/04/2023 |
| 7.2.7 | 1 | 01/27/2026 |
| 7.2.6 | 0 | 03/09/2024 |
| 7.2.5 | 0 | 02/22/2024 |
| 7.2.4 | 0 | 12/02/2023 |
| 7.2.3 | 0 | 11/03/2023 |
| 7.2.2 | 0 | 10/16/2023 |
| 7.2.1 | 0 | 07/11/2023 |
| 7.2.0 | 0 | 07/07/2023 |
| 7.1.2 | 0 | 04/19/2023 |
| 7.1.1 | 0 | 03/23/2023 |
| 7.1.0 | 1 | 01/27/2026 |
| 7.0.0 | 1 | 01/27/2026 |
| 7.0.0-rc2 | 1 | 01/27/2026 |
| 4.0.0-preview2 | 1 | 01/27/2026 |
| 4.0.0-preview1 | 1 | 01/27/2026 |
| 3.8.0 | 0 | 05/06/2025 |
| 3.8.0-preview5 | 1 | 01/27/2026 |
| 3.8.0-preview3 | 0 | 04/08/2025 |
| 3.8.0-preview2 | 1 | 01/27/2026 |
| 3.8.0-preview1 | 0 | 03/31/2025 |
| 3.7.2 | 0 | 05/10/2024 |
| 3.7.1 | 1 | 01/27/2026 |
| 3.7.0 | 1 | 01/27/2026 |
| 3.6.5 | 1 | 01/27/2026 |
| 3.6.4 | 0 | 08/10/2022 |
| 3.6.3 | 0 | 08/04/2022 |
| 3.6.2 | 1 | 01/27/2026 |
| 3.6.1 | 1 | 01/27/2026 |
| 3.6.0 | 0 | 01/20/2022 |
| 3.5.1 | 0 | 11/08/2021 |
| 3.5.0 | 1 | 01/27/2026 |
| 3.4.4 | 0 | 10/04/2021 |
| 3.4.3 | 0 | 06/03/2021 |
| 3.4.2 | 1 | 01/27/2026 |
| 3.4.1 | 0 | 02/03/2021 |
| 3.4.0 | 0 | 01/06/2021 |
| 3.4.0-rc1 | 1 | 01/27/2026 |
| 3.3.0 | 1 | 01/27/2026 |
| 3.3.0-rc2 | 0 | 09/02/2020 |
| 3.3.0-rc1 | 1 | 01/27/2026 |
| 3.2.2 | 0 | 07/22/2020 |
| 3.2.1 | 0 | 07/02/2020 |
| 3.2.0 | 0 | 06/04/2020 |
| 3.2.0-rc2 | 1 | 01/27/2026 |
| 3.2.0-rc1 | 1 | 01/27/2026 |
| 3.1.7 | 0 | 05/19/2020 |
| 3.1.6 | 0 | 04/16/2020 |
| 3.1.5 | 0 | 04/09/2020 |
| 3.1.4 | 1 | 01/27/2026 |
| 3.1.3 | 0 | 03/16/2020 |
| 3.1.2 | 0 | 03/05/2020 |
| 3.1.0 | 0 | 02/23/2020 |
| 3.1.0-rc3 | 0 | 02/13/2020 |
| 3.1.0-rc2 | 0 | 02/12/2020 |
| 3.1.0-rc1 | 1 | 01/27/2026 |
| 3.0.2 | 0 | 12/12/2019 |
| 3.0.1 | 0 | 11/27/2019 |
| 3.0.0 | 0 | 10/24/2019 |
| 3.0.0-rc2 | 0 | 10/16/2019 |
| 3.0.0-rc1 | 1 | 01/27/2026 |
| 3.0.0-beta1 | 0 | 08/16/2019 |
| 2.4.5 | 1 | 01/27/2026 |
| 2.4.4 | 0 | 11/27/2019 |
| 2.4.3 | 1 | 01/27/2026 |
| 2.4.2 | 1 | 01/27/2026 |
| 2.4.1 | 1 | 01/27/2026 |
| 2.4.0 | 0 | 08/08/2019 |
| 2.3.6 | 0 | 07/24/2019 |
| 2.3.5 | 1 | 01/27/2026 |
| 2.3.4 | 1 | 01/27/2026 |
| 2.3.3 | 0 | 06/02/2019 |
| 2.3.2 | 0 | 05/09/2019 |
| 2.3.1 | 1 | 01/27/2026 |
| 2.3.0 | 0 | 03/20/2019 |
| 2.3.0-rc2 | 0 | 03/13/2019 |
| 2.3.0-rc1 | 1 | 01/27/2026 |
| 2.2.4 | 0 | 02/25/2019 |
| 2.2.0 | 1 | 01/27/2026 |
| 2.2.0-rc1 | 0 | 12/04/2018 |
| 2.2.0-beta1 | 1 | 01/27/2026 |
| 2.1.2 | 1 | 01/27/2026 |
| 2.1.0 | 0 | 09/28/2018 |
| 2.1.0-rc2 | 0 | 09/21/2018 |
| 2.1.0-rc1 | 0 | 09/14/2018 |
| 2.1.0-beta1 | 1 | 01/27/2026 |
| 2.0.3 | 1 | 01/27/2026 |
| 2.0.0 | 0 | 03/28/2018 |
| 2.0.0-rc2 | 1 | 01/27/2026 |
| 2.0.0-rc1 | 0 | 02/26/2018 |
| 2.0.0-beta3 | 0 | 12/21/2017 |
| 2.0.0-beta2 | 1 | 01/27/2026 |
| 2.0.0-beta1 | 1 | 01/27/2026 |
| 1.5.10 | 0 | 10/10/2019 |
| 1.5.9 | 0 | 09/01/2019 |
| 1.5.8 | 1 | 01/27/2026 |
| 1.5.7 | 1 | 01/27/2026 |
| 1.5.6 | 0 | 09/28/2018 |
| 1.5.5 | 1 | 01/27/2026 |
| 1.5.4 | 0 | 06/13/2018 |
| 1.5.3 | 0 | 12/09/2017 |
| 1.5.2 | 0 | 10/17/2017 |
| 1.5.1 | 1 | 01/27/2026 |
| 1.5.0 | 1 | 01/27/2026 |
| 1.5.0-rc | 1 | 01/27/2026 |
| 1.5.0-beta1 | 0 | 04/29/2017 |
| 1.4.2 | 0 | 06/09/2017 |
| 1.4.1 | 0 | 03/27/2017 |
| 1.4.0 | 0 | 02/16/2017 |
| 1.4.0-beta | 1 | 01/27/2026 |
| 1.3.1 | 2 | 01/26/2026 |
| 1.3.0 | 0 | 10/12/2016 |
| 1.3.0-beta2 | 1 | 01/27/2026 |
| 1.3.0-beta1 | 0 | 07/28/2016 |
| 1.2.4 | 1 | 01/27/2026 |
| 1.2.3 | 0 | 07/12/2016 |
| 1.2.2 | 0 | 06/14/2016 |
| 1.2.1 | 0 | 05/18/2016 |
| 1.2.0 | 0 | 05/02/2016 |
| 1.2.0-beta | 1 | 01/27/2026 |
| 1.1.3 | 1 | 01/27/2026 |
| 1.1.2 | 1 | 01/27/2026 |
| 1.1.1 | 1 | 01/27/2026 |
| 1.1.0 | 0 | 12/14/2015 |
| 1.1.0-beta2 | 0 | 12/03/2015 |
| 1.1.0-beta1 | 1 | 01/27/2026 |
| 1.0.10 | 0 | 09/22/2015 |
| 1.0.9 | 0 | 07/16/2015 |
| 1.0.8 | 0 | 05/27/2015 |
| 1.0.7 | 1 | 01/27/2026 |
| 1.0.5 | 1 | 01/27/2026 |
| 1.0.3 | 1 | 01/27/2026 |
| 1.0.0 | 1 | 01/27/2026 |