Microsoft.Orleans.Core 9.2.1

Prefix Reserved

dotnet add package Microsoft.Orleans.Core --version 9.2.1

NuGet\Install-Package Microsoft.Orleans.Core -Version 9.2.1

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Microsoft.Orleans.Core" Version="9.2.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Microsoft.Orleans.Core" Version="9.2.1" />
                    

                            Directory.Packages.props

<PackageReference Include="Microsoft.Orleans.Core" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Microsoft.Orleans.Core --version 9.2.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Microsoft.Orleans.Core, 9.2.1"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Microsoft.Orleans.Core@9.2.1

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Microsoft.Orleans.Core&version=9.2.1
                    

                            Install as a Cake Addin

#tool nuget:?package=Microsoft.Orleans.Core&version=9.2.1
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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

Product	Compatible and additional computed target framework versions.
.NET	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 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.11)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 4.5.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.5.0)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.Configuration.Json (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.DependencyModel (>= 8.0.2)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 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.ObjectPool (>= 8.0.11)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Orleans.Analyzers (>= 9.2.1)
- Microsoft.Orleans.CodeGenerator (>= 9.2.1)
- Microsoft.Orleans.Core.Abstractions (>= 9.2.1)
- Newtonsoft.Json (>= 13.0.3)
- System.Collections.Immutable (>= 8.0.0)
- System.IO.Hashing (>= 8.0.0)
- System.IO.Pipelines (>= 8.0.0)
- System.Memory.Data (>= 8.0.1)

NuGet packages (108)

Showing the top 5 NuGet packages that depend on Microsoft.Orleans.Core:

Package	Downloads
Microsoft.Orleans.Runtime.Abstractions Library with core types shared between silo and extensions.	15.7M
Microsoft.Orleans.OrleansProviders Library of built-in persistence and stream providers included in Microsoft Orleans.	12.6M
Microsoft.Orleans.OrleansRuntime Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.	12.6M
Microsoft.Orleans.Sdk Microsoft Orleans meta package to bring in the base Orleans packages for all project types.	5.5M
Microsoft.Orleans.Runtime Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.	5.3M

GitHub repositories (12)

Showing the top 12 popular GitHub repositories that depend on Microsoft.Orleans.Core:

Repository	Stars
dodyg/practical-aspnetcore Practical samples of ASP.NET Core 10 Preview 7, 9, 8.0, 7.0, 6.0, 5.0, 3.1, 2.2, and 2.1,projects you can use. Readme contains explanations on all projects.	10.1K
dotnet/samples Sample code referenced by the .NET documentation	3.6K
dotnetGame/MineCase Minecraft server based on Orleans	800
OrleansContrib/OrleansDashboard :bar_chart: A developer dashboard for Microsoft Orleans	746
RayTale/Ray 项目停止更新，新项目：https://github.com/RayTale/Vertex	607
axzxs2001/Asp.NetCoreExperiment 原来所有项目都移动到OleVersion目录下进行保留。新的案例装以.net 5.0为主，一部分对以前案例进行升级，一部分将以前的工作经验总结出来，以供大家参考！	359
JasonBock/Rocks A mocking library based on the Compiler APIs (Roslyn + Mocks)	319
ReubenBond/Hagar Fast, flexible, and version-tolerant serializer for .NET	223
microsoft/Yams YAMS (Yet Another Microservices Solution) is a library that can be used to deploy and host microservices in the cloud (e.g. Azure) or on premises	204
PiotrJustyna/road-to-orleans This repository illustrates the road to orleans with practical, real-life examples. From most basic, to more advanced techniques.	160
OrleansContrib/Orleans.Http An HTTP API for Microsoft Orleans	112
OrleansContrib/Orleans.Providers.MongoDB A MongoDb implementation of the Orleans Providers: Membership, Storage and Reminders.	111

Version	Downloads	Last Updated
9.2.1	50,806	7/16/2025
9.2.0	4,406	7/14/2025
9.2.0-preview3	4,158	6/10/2025
9.2.0-preview2	938	6/4/2025
9.2.0-preview1	29,159	4/4/2025
9.1.2	456,630	2/13/2025
9.0.1	274,017	11/23/2024
9.0.0	21,833	11/14/2024
8.2.0	927,558	7/12/2024
8.2.0-preview1	6,314	5/22/2024
8.1.0	517,403	4/17/2024
8.1.0-preview3	5,326	3/11/2024
8.1.0-preview2	1,747	2/23/2024
8.1.0-preview1	2,227	2/13/2024
8.0.0	549,062	1/5/2024
8.0.0-rc2	2,625	12/20/2023
8.0.0-rc1	2,535	12/4/2023
7.2.7	10,658	10/15/2024
7.2.6	90,463	3/9/2024
7.2.5	20,590	2/22/2024
7.2.4	393,307	12/2/2023
7.2.3	161,749	11/3/2023
7.2.2	87,439	10/16/2023
7.2.1	624,024	7/11/2023
7.2.0	476,652	7/7/2023
7.1.2	291,008	4/19/2023
7.1.1	117,470	3/23/2023
7.1.0	294,654	2/1/2023
7.0.0	409,378	11/8/2022
7.0.0-rc2	2,539	10/19/2022
4.0.0-preview2	24,744	8/4/2022
4.0.0-preview1	27,389	2/10/2022
3.8.0	33,086	5/6/2025
3.8.0-preview5	964	5/12/2025
3.8.0-preview3	1,004	4/8/2025
3.8.0-preview2	887	4/4/2025
3.8.0-preview1	937	3/31/2025
3.7.2	229,805	5/10/2024
3.7.1	326,174	5/27/2023
3.7.0	160,411	3/23/2023
3.6.5	2,151,161	8/15/2022
3.6.4	57,350	8/10/2022
3.6.3	98,594	8/4/2022
3.6.2	1,561,925	4/15/2022
3.6.1	347,584	4/5/2022
3.6.0	1,088,792	1/20/2022
3.5.1	980,203	11/8/2021
3.5.0	556,550	9/3/2021
3.4.4	24,973	10/4/2021
3.4.3	456,732	6/3/2021
3.4.2	312,600	4/5/2021
3.4.1	383,292	2/3/2021
3.4.0	1,042,583	1/6/2021
3.4.0-rc1	33,780	12/9/2020
3.3.0	655,784	9/9/2020
3.3.0-rc2	40,427	9/2/2020
3.3.0-rc1	6,550	8/19/2020
3.2.2	178,067	7/22/2020
3.2.1	64,334	7/2/2020
3.2.0	253,555	6/4/2020
3.2.0-rc2	11,427	5/20/2020
3.2.0-rc1	7,590	5/7/2020
3.1.7	617,713	5/19/2020
3.1.6	585,773	4/16/2020
3.1.5	20,594	4/9/2020
3.1.4	449,163	3/26/2020
3.1.3	46,800	3/16/2020
3.1.2	64,725	3/5/2020
3.1.0	44,765	2/23/2020
3.1.0-rc3	7,229	2/13/2020
3.1.0-rc2	6,896	2/12/2020
3.1.0-rc1	6,386	2/10/2020
3.0.2	291,247	12/12/2019
3.0.1	41,913	11/27/2019
3.0.0	367,687	10/24/2019
3.0.0-rc2	11,997	10/16/2019
3.0.0-rc1	10,689	10/9/2019
3.0.0-beta1	28,651	8/16/2019
2.4.5	245,952	12/29/2019
2.4.4	96,102	11/27/2019
2.4.3	102,868	10/10/2019
2.4.2	150,423	8/31/2019
2.4.1	74,577	8/14/2019
2.4.0	36,877	8/8/2019
2.3.6	63,542	7/24/2019
2.3.5	158,634	6/14/2019
2.3.4	195,855	6/4/2019
2.3.3	18,746	6/2/2019
2.3.2	115,387	5/9/2019
2.3.1	34,057	4/26/2019
2.3.0	253,263	3/20/2019
2.3.0-rc2	11,595	3/13/2019
2.3.0-rc1	10,676	3/4/2019
2.2.4	35,089	2/25/2019
2.2.0	135,265	12/13/2018
2.2.0-rc1	10,175	12/4/2018
2.2.0-beta1	11,482	10/21/2018
2.1.2	188,442	10/11/2018
2.1.0	46,096	9/28/2018
2.1.0-rc2	10,970	9/21/2018
2.1.0-rc1	10,775	9/14/2018
2.1.0-beta1	18,039	8/27/2018
2.0.3	169,557	5/11/2018
2.0.0	203,156	3/28/2018
2.0.0-rc2	23,513	3/13/2018
2.0.0-rc1	24,492	2/26/2018
2.0.0-beta3	29,689	12/21/2017
2.0.0-beta2	9,935	12/11/2017
2.0.0-beta1	12,337	10/26/2017
1.5.10	37,428	10/10/2019
1.5.9	11,807	9/1/2019
1.5.8	12,683	5/31/2019
1.5.7	12,295	2/28/2019
1.5.6	17,969	9/28/2018
1.5.5	12,534	9/8/2018
1.5.4	26,538	6/13/2018
1.5.3	65,111	12/9/2017
1.5.2	56,980	10/17/2017
1.5.1	26,843	8/28/2017
1.5.0	55,967	7/6/2017
1.5.0-rc	6,662	6/20/2017
1.5.0-beta1	6,778	4/29/2017
1.4.2	21,450	6/9/2017
1.4.1	32,798	3/27/2017
1.4.0	17,832	2/16/2017
1.4.0-beta	5,691	2/1/2017
1.3.1	206,491	11/11/2016
1.3.0	24,098	10/12/2016
1.3.0-beta2	6,342	9/24/2016
1.3.0-beta1	9,785	7/28/2016
1.2.4	9,115	10/5/2016
1.2.3	20,188	7/12/2016
1.2.2	12,537	6/14/2016
1.2.1	9,448	5/18/2016
1.2.0	18,811	5/2/2016
1.2.0-beta	6,053	4/19/2016
1.1.3	16,818	3/9/2016
1.1.2	15,511	1/20/2016
1.1.1	7,635	1/11/2016
1.1.0	14,655	12/14/2015
1.1.0-beta2	5,798	12/3/2015
1.1.0-beta1	5,760	11/3/2015
1.0.10	40,324	9/22/2015
1.0.9	16,302	7/16/2015
1.0.8	11,607	5/27/2015
1.0.7	2,661	5/15/2015
1.0.5	17,066	3/20/2015
1.0.3	4,946	2/27/2015
1.0.0	12,607	2/6/2015