Microsoft.Orleans.Client
9.2.1
Prefix Reserved
dotnet add package Microsoft.Orleans.Client --version 9.2.1
NuGet\Install-Package Microsoft.Orleans.Client -Version 9.2.1
<PackageReference Include="Microsoft.Orleans.Client" Version="9.2.1" />
<PackageVersion Include="Microsoft.Orleans.Client" Version="9.2.1" />
<PackageReference Include="Microsoft.Orleans.Client" />
paket add Microsoft.Orleans.Client --version 9.2.1
#r "nuget: Microsoft.Orleans.Client, 9.2.1"
#:package Microsoft.Orleans.Client@9.2.1
#addin nuget:?package=Microsoft.Orleans.Client&version=9.2.1
#tool nuget:?package=Microsoft.Orleans.Client&version=9.2.1
Microsoft Orleans Client
Introduction
Microsoft Orleans Client is a metapackage that includes all the necessary components to connect to an Orleans cluster from a client application. It provides a simplified way to set up an Orleans client by providing a single package reference rather than requiring you to reference multiple packages individually.
Getting Started
To use this package, install it via NuGet:
dotnet add package Microsoft.Orleans.Client
Example - Creating an Orleans Client
using Microsoft.Extensions.Hosting;
using Orleans;
using Orleans.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Threading.Tasks;
namespace ExampleGrains;
// Define a grain interface
public interface IMyGrain : IGrainWithStringKey
{
Task<string> DoSomething();
}
// 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 client = host.Services.GetRequiredService<IClusterClient>();
var grain = client.GetGrain<IMyGrain>("my-grain-id");
var result = await grain.DoSomething();
// Print the result
Console.WriteLine($"Result: {result}");
// Keep the host running until the application is shut down
await host.WaitForShutdownAsync();
Documentation
For more comprehensive documentation, please refer to:
- Microsoft Orleans Documentation
- Orleans client configuration
- Grain references
- Orleans request context
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
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.Sdk (>= 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 (46)
Showing the top 5 NuGet packages that depend on Microsoft.Orleans.Client:
| Package | Downloads |
|---|---|
|
Blauhaus.Orleans
Package Description |
|
|
Blauhaus.EVACS.Orleans
Package Description |
|
|
OrleansDashboard.Client
An admin dashboard for Microsoft Orleans |
|
|
Mtl.Infrastructures.Workers
主要是封装了下Netty服务器和客户端的方法,提供了简单的方法调用就能启动Netty服务器和客户端,封装了Orleans的服务器和客户端的启动和连接方法,使操作简单,减少重复的代码 |
|
|
Orleans.MultiClient
Orleans' Multi Client |
GitHub repositories (12)
Showing the top 12 popular GitHub repositories that depend on Microsoft.Orleans.Client:
| Repository | Stars |
|---|---|
|
dotnet/aspire
Aspire is the tool for code-first, extensible, observable dev and deploy.
|
|
|
dotnet/samples
Sample code referenced by the .NET documentation
|
|
|
Dotnet-Boxed/Templates
.NET project templates with batteries included, providing the minimum amount of code required to get you going faster.
|
|
|
dotnetGame/MineCase
Minecraft server based on Orleans
|
|
|
OrleansContrib/OrleansDashboard
:bar_chart: A developer dashboard for Microsoft Orleans
|
|
|
OrleansContrib/Orleankka
Functional API for Microsoft Orleans http://orleanscontrib.github.io/Orleankka
|
|
|
Maarten88/rrod
Exploring a new web architecture with React, Redux, Orleans and Dotnet Core
|
|
|
axzxs2001/Asp.NetCoreExperiment
原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主,一部分对以前案例进行升级,一部分将以前的工作经验总结出来,以供大家参考!
|
|
|
EasyAbp/EShop
An abp application module group that provides basic e-shop service.
|
|
|
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
|
|
|
OrleansContrib/Orleans.Clustering.Kubernetes
Orleans Membership provider for Kubernetes
|
|
|
PiotrJustyna/road-to-orleans
This repository illustrates the road to orleans with practical, real-life examples. From most basic, to more advanced techniques.
|
| Version | Downloads | Last Updated |
|---|---|---|
| 9.2.1 | 163,197 | 7/16/2025 |
| 9.2.0 | 3,992 | 7/14/2025 |
| 9.2.0-preview3 | 8,803 | 6/10/2025 |
| 9.2.0-preview2 | 828 | 6/4/2025 |
| 9.2.0-preview1 | 8,554 | 4/4/2025 |
| 9.1.2 | 273,945 | 2/13/2025 |
| 9.0.1 | 120,130 | 11/23/2024 |
| 9.0.0 | 12,437 | 11/14/2024 |
| 8.2.0 | 439,022 | 7/12/2024 |
| 8.2.0-preview1 | 592 | 5/22/2024 |
| 8.1.0 | 180,658 | 4/17/2024 |
| 8.1.0-preview3 | 1,622 | 3/11/2024 |
| 8.1.0-preview2 | 667 | 2/23/2024 |
| 8.1.0-preview1 | 473 | 2/13/2024 |
| 8.0.0 | 147,288 | 1/5/2024 |
| 8.0.0-rc2 | 638 | 12/20/2023 |
| 8.0.0-rc1 | 697 | 12/4/2023 |
| 7.2.7 | 5,297 | 10/15/2024 |
| 7.2.6 | 40,071 | 3/9/2024 |
| 7.2.5 | 10,505 | 2/22/2024 |
| 7.2.4 | 115,797 | 12/2/2023 |
| 7.2.3 | 60,722 | 11/3/2023 |
| 7.2.2 | 50,504 | 10/16/2023 |
| 7.2.1 | 124,305 | 7/11/2023 |
| 7.2.0 | 8,966 | 7/7/2023 |
| 7.1.2 | 124,793 | 4/19/2023 |
| 7.1.1 | 69,214 | 3/23/2023 |
| 7.1.0 | 93,378 | 2/1/2023 |
| 7.0.0 | 112,212 | 11/8/2022 |
| 7.0.0-rc2 | 985 | 10/19/2022 |
| 4.0.0-preview2 | 10,201 | 8/4/2022 |
| 4.0.0-preview1 | 6,550 | 2/10/2022 |
| 3.8.0 | 5,607 | 5/6/2025 |
| 3.8.0-preview5 | 393 | 5/12/2025 |
| 3.8.0-preview3 | 376 | 4/8/2025 |
| 3.8.0-preview2 | 302 | 4/4/2025 |
| 3.8.0-preview1 | 340 | 3/31/2025 |
| 3.7.2 | 38,516 | 5/10/2024 |
| 3.7.1 | 102,824 | 5/27/2023 |
| 3.7.0 | 12,117 | 3/23/2023 |
| 3.6.5 | 987,913 | 8/15/2022 |
| 3.6.4 | 11,011 | 8/10/2022 |
| 3.6.3 | 49,317 | 8/4/2022 |
| 3.6.2 | 774,783 | 4/15/2022 |
| 3.6.1 | 110,699 | 4/5/2022 |
| 3.6.0 | 184,829 | 1/20/2022 |
| 3.5.1 | 317,867 | 11/8/2021 |
| 3.5.0 | 178,583 | 9/3/2021 |
| 3.4.4 | 12,136 | 10/4/2021 |
| 3.4.3 | 163,550 | 6/3/2021 |
| 3.4.2 | 67,333 | 4/5/2021 |
| 3.4.1 | 136,566 | 2/3/2021 |
| 3.4.0 | 1,354,872 | 1/6/2021 |
| 3.4.0-rc1 | 845 | 12/9/2020 |
| 3.3.0 | 145,893 | 9/9/2020 |
| 3.3.0-rc2 | 850 | 9/2/2020 |
| 3.3.0-rc1 | 781 | 8/19/2020 |
| 3.2.2 | 24,858 | 7/22/2020 |
| 3.2.1 | 18,397 | 7/2/2020 |
| 3.2.0 | 87,886 | 6/4/2020 |
| 3.2.0-rc2 | 4,720 | 5/20/2020 |
| 3.2.0-rc1 | 1,150 | 5/7/2020 |
| 3.1.7 | 27,116 | 5/19/2020 |
| 3.1.6 | 659,065 | 4/16/2020 |
| 3.1.5 | 3,395 | 4/9/2020 |
| 3.1.4 | 11,263 | 3/26/2020 |
| 3.1.3 | 16,498 | 3/16/2020 |
| 3.1.2 | 6,626 | 3/5/2020 |
| 3.1.0 | 13,778 | 2/23/2020 |
| 3.1.0-rc3 | 1,101 | 2/13/2020 |
| 3.1.0-rc2 | 1,008 | 2/12/2020 |
| 3.1.0-rc1 | 944 | 2/10/2020 |
| 3.0.2 | 44,321 | 12/12/2019 |
| 3.0.1 | 7,717 | 11/27/2019 |
| 3.0.0 | 203,572 | 10/24/2019 |
| 3.0.0-rc2 | 1,508 | 10/16/2019 |
| 3.0.0-rc1 | 1,131 | 10/9/2019 |
| 3.0.0-beta1 | 2,282 | 8/16/2019 |
| 2.4.5 | 14,853 | 12/29/2019 |
| 2.4.4 | 12,430 | 11/27/2019 |
| 2.4.3 | 54,975 | 10/10/2019 |
| 2.4.2 | 139,780 | 8/31/2019 |
| 2.4.1 | 42,309 | 8/14/2019 |
| 2.4.0 | 19,007 | 8/8/2019 |
| 2.3.6 | 16,601 | 7/24/2019 |
| 2.3.5 | 80,834 | 6/14/2019 |
| 2.3.4 | 38,604 | 6/4/2019 |
| 2.3.3 | 3,453 | 6/2/2019 |
| 2.3.2 | 28,836 | 5/9/2019 |
| 2.3.1 | 14,206 | 4/26/2019 |
| 2.3.0 | 82,849 | 3/20/2019 |
| 2.3.0-rc2 | 2,250 | 3/13/2019 |
| 2.3.0-rc1 | 1,173 | 3/4/2019 |
| 2.2.4 | 14,110 | 2/25/2019 |
| 2.2.0 | 53,338 | 12/13/2018 |
| 2.2.0-rc1 | 1,184 | 12/4/2018 |
| 2.2.0-beta1 | 1,734 | 10/21/2018 |
| 2.1.2 | 45,505 | 10/11/2018 |
| 2.1.0 | 17,828 | 9/28/2018 |
| 2.1.0-rc2 | 1,986 | 9/21/2018 |
| 2.1.0-rc1 | 1,880 | 9/14/2018 |
| 2.1.0-beta1 | 3,438 | 8/27/2018 |
| 2.0.3 | 74,325 | 5/31/2018 |
| 2.0.0 | 16,002 | 3/28/2018 |
| 2.0.0-rc2 | 3,560 | 3/13/2018 |
| 2.0.0-rc1 | 2,514 | 2/26/2018 |
| 2.0.0-beta3 | 7,813 | 12/21/2017 |
| 2.0.0-beta2 | 1,772 | 12/11/2017 |
| 2.0.0-beta1 | 3,375 | 10/26/2017 |
| 1.5.10 | 10,902 | 10/10/2019 |
| 1.5.9 | 1,173 | 9/1/2019 |
| 1.5.8 | 1,243 | 5/31/2019 |
| 1.5.7 | 1,252 | 2/28/2019 |
| 1.5.6 | 2,200 | 9/28/2018 |
| 1.5.5 | 1,839 | 9/8/2018 |
| 1.5.4 | 11,835 | 6/13/2018 |
| 1.5.3 | 22,858 | 12/9/2017 |
| 1.5.2 | 11,118 | 10/17/2017 |
| 1.5.1 | 4,433 | 8/28/2017 |
| 1.5.0 | 6,146 | 7/6/2017 |
| 1.5.0-rc | 1,624 | 6/20/2017 |
| 1.5.0-beta1 | 1,675 | 4/29/2017 |
| 1.4.2 | 6,624 | 6/9/2017 |
| 1.4.1 | 8,012 | 3/27/2017 |
| 1.4.0 | 5,887 | 2/16/2017 |
| 1.4.0-beta | 1,587 | 2/1/2017 |
| 1.3.1 | 6,194 | 11/11/2016 |
| 1.3.0 | 4,330 | 10/12/2016 |
| 1.3.0-beta2 | 1,899 | 9/24/2016 |
| 1.3.0-beta1 | 2,207 | 7/28/2016 |
| 1.2.4 | 2,650 | 10/5/2016 |
| 1.2.3 | 4,716 | 7/12/2016 |
| 1.2.2 | 2,710 | 6/14/2016 |
| 1.2.1 | 2,628 | 5/18/2016 |
| 1.2.0 | 4,686 | 5/2/2016 |
| 1.2.0-beta | 1,709 | 4/19/2016 |
| 1.1.3 | 5,075 | 3/9/2016 |
| 1.1.2 | 3,820 | 1/20/2016 |
| 1.1.1 | 2,481 | 1/11/2016 |
| 1.1.0 | 3,365 | 12/14/2015 |
| 1.1.0-beta2 | 1,882 | 12/3/2015 |
| 1.1.0-beta1 | 1,710 | 11/3/2015 |
| 1.0.10 | 5,245 | 9/22/2015 |
| 1.0.9 | 4,708 | 7/16/2015 |
| 1.0.8 | 5,793 | 5/27/2015 |
| 1.0.7 | 2,450 | 5/15/2015 |
| 1.0.5 | 2,823 | 3/20/2015 |
| 1.0.3 | 3,054 | 2/27/2015 |
| 1.0.0 | 5,503 | 2/6/2015 |