Microsoft.Orleans.Core 9.2.0-preview2

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of Microsoft.Orleans.Core.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Microsoft.Orleans.Core --version 9.2.0-preview2
                    


                    

                
NuGet\Install-Package Microsoft.Orleans.Core -Version 9.2.0-preview2
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.0-preview2" />
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.0-preview2" />
                    


                            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.0-preview2
                    


                    

                
#r "nuget: Microsoft.Orleans.Core, 9.2.0-preview2"
#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.0-preview2
#: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.0-preview2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Microsoft.Orleans.Core&version=9.2.0-preview2&prerelease
                    


                            Install as a Cake Tool

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

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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.
Microsoft.Orleans.OrleansProviders

Library of built-in persistence and stream providers included in Microsoft Orleans.
Microsoft.Orleans.OrleansRuntime

Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
Microsoft.Orleans.Sdk

Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
Microsoft.Orleans.Runtime

Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.

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.
dotnet/samples
Sample code referenced by the .NET documentation
dotnetGame/MineCase
Minecraft server based on Orleans
OrleansContrib/OrleansDashboard
:bar_chart: A developer dashboard for Microsoft Orleans
RayTale/Ray
项目停止更新，新项目：https://github.com/RayTale/Vertex
axzxs2001/Asp.NetCoreExperiment
原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主，一部分对以前案例进行升级，一部分将以前的工作经验总结出来，以供大家参考！
JasonBock/Rocks
A mocking library based on the Compiler APIs (Roslyn + Mocks)
ReubenBond/Hagar
Fast, flexible, and version-tolerant serializer for .NET
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
PiotrJustyna/road-to-orleans
This repository illustrates the road to orleans with practical, real-life examples. From most basic, to more advanced techniques.
OrleansContrib/Orleans.Http
An HTTP API for Microsoft Orleans
OrleansContrib/Orleans.Providers.MongoDB
A MongoDb implementation of the Orleans Providers: Membership, Storage and Reminders.
Version Downloads Last Updated
9.2.1 60,715 7/16/2025
9.2.0 4,562 7/14/2025
9.2.0-preview3 4,307 6/10/2025
9.2.0-preview2 938 6/4/2025
9.2.0-preview1 29,268 4/4/2025
9.1.2 467,130 2/13/2025
9.0.1 276,232 11/23/2024
9.0.0 22,006 11/14/2024
8.2.0 946,708 7/12/2024
8.2.0-preview1 6,358 5/22/2024
8.1.0 520,163 4/17/2024
8.1.0-preview3 5,327 3/11/2024
8.1.0-preview2 1,749 2/23/2024
8.1.0-preview1 2,228 2/13/2024
8.0.0 552,408 1/5/2024
8.0.0-rc2 2,626 12/20/2023
8.0.0-rc1 2,537 12/4/2023
7.2.7 11,023 10/15/2024
7.2.6 90,730 3/9/2024
7.2.5 20,740 2/22/2024
7.2.4 395,406 12/2/2023
7.2.3 162,050 11/3/2023
7.2.2 87,452 10/16/2023
7.2.1 627,078 7/11/2023
7.2.0 479,813 7/7/2023
7.1.2 291,254 4/19/2023
7.1.1 117,714 3/23/2023
7.1.0 294,771 2/1/2023
7.0.0 410,006 11/8/2022
7.0.0-rc2 2,539 10/19/2022
4.0.0-preview2 24,751 8/4/2022
4.0.0-preview1 27,411 2/10/2022
3.8.0 33,725 5/6/2025
3.8.0-preview5 964 5/12/2025
3.8.0-preview3 1,005 4/8/2025
3.8.0-preview2 887 4/4/2025
3.8.0-preview1 937 3/31/2025
3.7.2 231,587 5/10/2024
3.7.1 327,046 5/27/2023
3.7.0 161,756 3/23/2023
3.6.5 2,152,317 8/15/2022
3.6.4 57,356 8/10/2022
3.6.3 98,610 8/4/2022
3.6.2 1,563,115 4/15/2022
3.6.1 347,642 4/5/2022
3.6.0 1,091,095 1/20/2022
3.5.1 981,280 11/8/2021
3.5.0 557,066 9/3/2021
3.4.4 24,980 10/4/2021
3.4.3 457,236 6/3/2021
3.4.2 313,383 4/5/2021
3.4.1 384,214 2/3/2021
3.4.0 1,045,441 1/6/2021
3.4.0-rc1 33,782 12/9/2020
3.3.0 656,748 9/9/2020
3.3.0-rc2 40,428 9/2/2020
3.3.0-rc1 6,551 8/19/2020
3.2.2 178,104 7/22/2020
3.2.1 64,344 7/2/2020
3.2.0 253,635 6/4/2020
3.2.0-rc2 11,488 5/20/2020
3.2.0-rc1 7,591 5/7/2020
3.1.7 618,041 5/19/2020
3.1.6 586,032 4/16/2020
3.1.5 20,596 4/9/2020
3.1.4 450,908 3/26/2020
3.1.3 46,802 3/16/2020
3.1.2 64,728 3/5/2020
3.1.0 44,769 2/23/2020
3.1.0-rc3 7,230 2/13/2020
3.1.0-rc2 6,897 2/12/2020
3.1.0-rc1 6,387 2/10/2020
3.0.2 291,253 12/12/2019
3.0.1 41,915 11/27/2019
3.0.0 368,179 10/24/2019
3.0.0-rc2 11,998 10/16/2019
3.0.0-rc1 10,690 10/9/2019
3.0.0-beta1 28,674 8/16/2019
2.4.5 246,121 12/29/2019
2.4.4 96,239 11/27/2019
2.4.3 102,871 10/10/2019
2.4.2 150,492 8/31/2019
2.4.1 74,622 8/14/2019
2.4.0 36,898 8/8/2019
2.3.6 63,547 7/24/2019
2.3.5 158,770 6/14/2019
2.3.4 195,864 6/4/2019
2.3.3 18,747 6/2/2019
2.3.2 115,389 5/9/2019
2.3.1 34,058 4/26/2019
2.3.0 253,310 3/20/2019
2.3.0-rc2 11,596 3/13/2019
2.3.0-rc1 10,677 3/4/2019
2.2.4 35,108 2/25/2019
2.2.0 135,277 12/13/2018
2.2.0-rc1 10,177 12/4/2018
2.2.0-beta1 11,483 10/21/2018
2.1.2 188,443 10/11/2018
2.1.0 46,097 9/28/2018
2.1.0-rc2 10,974 9/21/2018
2.1.0-rc1 10,776 9/14/2018
2.1.0-beta1 18,040 8/27/2018
2.0.3 169,563 5/11/2018
2.0.0 203,191 3/28/2018
2.0.0-rc2 23,515 3/13/2018
2.0.0-rc1 24,496 2/26/2018
2.0.0-beta3 29,691 12/21/2017
2.0.0-beta2 9,938 12/11/2017
2.0.0-beta1 12,340 10/26/2017
1.5.10 37,461 10/10/2019
1.5.9 11,808 9/1/2019
1.5.8 12,685 5/31/2019
1.5.7 12,296 2/28/2019
1.5.6 17,970 9/28/2018
1.5.5 12,535 9/8/2018
1.5.4 26,541 6/13/2018
1.5.3 65,149 12/9/2017
1.5.2 56,983 10/17/2017
1.5.1 26,845 8/28/2017
1.5.0 55,970 7/6/2017
1.5.0-rc 6,666 6/20/2017
1.5.0-beta1 6,780 4/29/2017
1.4.2 21,452 6/9/2017
1.4.1 32,807 3/27/2017
1.4.0 17,835 2/16/2017
1.4.0-beta 5,694 2/1/2017
1.3.1 206,502 11/11/2016
1.3.0 24,109 10/12/2016
1.3.0-beta2 6,344 9/24/2016
1.3.0-beta1 9,788 7/28/2016
1.2.4 9,117 10/5/2016
1.2.3 20,190 7/12/2016
1.2.2 12,539 6/14/2016
1.2.1 9,451 5/18/2016
1.2.0 18,813 5/2/2016
1.2.0-beta 6,056 4/19/2016
1.1.3 16,825 3/9/2016
1.1.2 15,513 1/20/2016
1.1.1 7,637 1/11/2016
1.1.0 14,665 12/14/2015
1.1.0-beta2 5,801 12/3/2015
1.1.0-beta1 5,762 11/3/2015
1.0.10 40,336 9/22/2015
1.0.9 16,307 7/16/2015
1.0.8 11,615 5/27/2015
1.0.7 2,665 5/15/2015
1.0.5 17,069 3/20/2015
1.0.3 4,950 2/27/2015
1.0.0 12,627 2/6/2015