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 | 169,254 | 7/16/2025 |
| 9.2.0 | 3,998 | 7/14/2025 |
| 9.2.0-preview3 | 8,818 | 6/10/2025 |
| 9.2.0-preview2 | 829 | 6/4/2025 |
| 9.2.0-preview1 | 8,554 | 4/4/2025 |
| 9.1.2 | 276,151 | 2/13/2025 |
| 9.0.1 | 120,701 | 11/23/2024 |
| 9.0.0 | 12,474 | 11/14/2024 |
| 8.2.0 | 441,518 | 7/12/2024 |
| 8.2.0-preview1 | 592 | 5/22/2024 |
| 8.1.0 | 181,059 | 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,588 | 1/5/2024 |
| 8.0.0-rc2 | 639 | 12/20/2023 |
| 8.0.0-rc1 | 697 | 12/4/2023 |
| 7.2.7 | 5,332 | 10/15/2024 |
| 7.2.6 | 40,260 | 3/9/2024 |
| 7.2.5 | 10,510 | 2/22/2024 |
| 7.2.4 | 116,323 | 12/2/2023 |
| 7.2.3 | 60,781 | 11/3/2023 |
| 7.2.2 | 50,511 | 10/16/2023 |
| 7.2.1 | 124,398 | 7/11/2023 |
| 7.2.0 | 8,967 | 7/7/2023 |
| 7.1.2 | 124,831 | 4/19/2023 |
| 7.1.1 | 69,219 | 3/23/2023 |
| 7.1.0 | 93,397 | 2/1/2023 |
| 7.0.0 | 112,232 | 11/8/2022 |
| 7.0.0-rc2 | 988 | 10/19/2022 |
| 4.0.0-preview2 | 10,204 | 8/4/2022 |
| 4.0.0-preview1 | 6,554 | 2/10/2022 |
| 3.8.0 | 5,867 | 5/6/2025 |
| 3.8.0-preview5 | 393 | 5/12/2025 |
| 3.8.0-preview3 | 379 | 4/8/2025 |
| 3.8.0-preview2 | 302 | 4/4/2025 |
| 3.8.0-preview1 | 340 | 3/31/2025 |
| 3.7.2 | 38,588 | 5/10/2024 |
| 3.7.1 | 103,068 | 5/27/2023 |
| 3.7.0 | 12,121 | 3/23/2023 |
| 3.6.5 | 988,178 | 8/15/2022 |
| 3.6.4 | 11,015 | 8/10/2022 |
| 3.6.3 | 49,323 | 8/4/2022 |
| 3.6.2 | 774,848 | 4/15/2022 |
| 3.6.1 | 110,702 | 4/5/2022 |
| 3.6.0 | 184,882 | 1/20/2022 |
| 3.5.1 | 318,011 | 11/8/2021 |
| 3.5.0 | 178,604 | 9/3/2021 |
| 3.4.4 | 12,140 | 10/4/2021 |
| 3.4.3 | 163,615 | 6/3/2021 |
| 3.4.2 | 67,341 | 4/5/2021 |
| 3.4.1 | 136,571 | 2/3/2021 |
| 3.4.0 | 1,356,801 | 1/6/2021 |
| 3.4.0-rc1 | 848 | 12/9/2020 |
| 3.3.0 | 145,905 | 9/9/2020 |
| 3.3.0-rc2 | 853 | 9/2/2020 |
| 3.3.0-rc1 | 785 | 8/19/2020 |
| 3.2.2 | 24,874 | 7/22/2020 |
| 3.2.1 | 18,400 | 7/2/2020 |
| 3.2.0 | 87,890 | 6/4/2020 |
| 3.2.0-rc2 | 4,736 | 5/20/2020 |
| 3.2.0-rc1 | 1,153 | 5/7/2020 |
| 3.1.7 | 27,130 | 5/19/2020 |
| 3.1.6 | 659,267 | 4/16/2020 |
| 3.1.5 | 3,398 | 4/9/2020 |
| 3.1.4 | 11,266 | 3/26/2020 |
| 3.1.3 | 16,502 | 3/16/2020 |
| 3.1.2 | 6,629 | 3/5/2020 |
| 3.1.0 | 13,783 | 2/23/2020 |
| 3.1.0-rc3 | 1,106 | 2/13/2020 |
| 3.1.0-rc2 | 1,011 | 2/12/2020 |
| 3.1.0-rc1 | 947 | 2/10/2020 |
| 3.0.2 | 44,324 | 12/12/2019 |
| 3.0.1 | 7,721 | 11/27/2019 |
| 3.0.0 | 203,581 | 10/24/2019 |
| 3.0.0-rc2 | 1,511 | 10/16/2019 |
| 3.0.0-rc1 | 1,135 | 10/9/2019 |
| 3.0.0-beta1 | 2,285 | 8/16/2019 |
| 2.4.5 | 14,863 | 12/29/2019 |
| 2.4.4 | 12,433 | 11/27/2019 |
| 2.4.3 | 54,978 | 10/10/2019 |
| 2.4.2 | 139,825 | 8/31/2019 |
| 2.4.1 | 42,330 | 8/14/2019 |
| 2.4.0 | 19,022 | 8/8/2019 |
| 2.3.6 | 16,606 | 7/24/2019 |
| 2.3.5 | 80,838 | 6/14/2019 |
| 2.3.4 | 38,624 | 6/4/2019 |
| 2.3.3 | 3,456 | 6/2/2019 |
| 2.3.2 | 28,840 | 5/9/2019 |
| 2.3.1 | 14,210 | 4/26/2019 |
| 2.3.0 | 82,854 | 3/20/2019 |
| 2.3.0-rc2 | 2,253 | 3/13/2019 |
| 2.3.0-rc1 | 1,175 | 3/4/2019 |
| 2.2.4 | 14,112 | 2/25/2019 |
| 2.2.0 | 53,339 | 12/13/2018 |
| 2.2.0-rc1 | 1,185 | 12/4/2018 |
| 2.2.0-beta1 | 1,736 | 10/21/2018 |
| 2.1.2 | 45,507 | 10/11/2018 |
| 2.1.0 | 17,832 | 9/28/2018 |
| 2.1.0-rc2 | 1,990 | 9/21/2018 |
| 2.1.0-rc1 | 1,884 | 9/14/2018 |
| 2.1.0-beta1 | 3,442 | 8/27/2018 |
| 2.0.3 | 74,339 | 5/31/2018 |
| 2.0.0 | 16,010 | 3/28/2018 |
| 2.0.0-rc2 | 3,567 | 3/13/2018 |
| 2.0.0-rc1 | 2,521 | 2/26/2018 |
| 2.0.0-beta3 | 7,819 | 12/21/2017 |
| 2.0.0-beta2 | 1,776 | 12/11/2017 |
| 2.0.0-beta1 | 3,380 | 10/26/2017 |
| 1.5.10 | 10,921 | 10/10/2019 |
| 1.5.9 | 1,176 | 9/1/2019 |
| 1.5.8 | 1,246 | 5/31/2019 |
| 1.5.7 | 1,254 | 2/28/2019 |
| 1.5.6 | 2,205 | 9/28/2018 |
| 1.5.5 | 1,843 | 9/8/2018 |
| 1.5.4 | 11,839 | 6/13/2018 |
| 1.5.3 | 22,883 | 12/9/2017 |
| 1.5.2 | 11,122 | 10/17/2017 |
| 1.5.1 | 4,439 | 8/28/2017 |
| 1.5.0 | 6,154 | 7/6/2017 |
| 1.5.0-rc | 1,629 | 6/20/2017 |
| 1.5.0-beta1 | 1,679 | 4/29/2017 |
| 1.4.2 | 6,629 | 6/9/2017 |
| 1.4.1 | 8,020 | 3/27/2017 |
| 1.4.0 | 5,892 | 2/16/2017 |
| 1.4.0-beta | 1,591 | 2/1/2017 |
| 1.3.1 | 6,199 | 11/11/2016 |
| 1.3.0 | 4,334 | 10/12/2016 |
| 1.3.0-beta2 | 1,905 | 9/24/2016 |
| 1.3.0-beta1 | 2,211 | 7/28/2016 |
| 1.2.4 | 2,655 | 10/5/2016 |
| 1.2.3 | 4,720 | 7/12/2016 |
| 1.2.2 | 2,714 | 6/14/2016 |
| 1.2.1 | 2,633 | 5/18/2016 |
| 1.2.0 | 4,690 | 5/2/2016 |
| 1.2.0-beta | 1,714 | 4/19/2016 |
| 1.1.3 | 5,081 | 3/9/2016 |
| 1.1.2 | 3,825 | 1/20/2016 |
| 1.1.1 | 2,484 | 1/11/2016 |
| 1.1.0 | 3,368 | 12/14/2015 |
| 1.1.0-beta2 | 1,885 | 12/3/2015 |
| 1.1.0-beta1 | 1,713 | 11/3/2015 |
| 1.0.10 | 5,255 | 9/22/2015 |
| 1.0.9 | 4,712 | 7/16/2015 |
| 1.0.8 | 5,796 | 5/27/2015 |
| 1.0.7 | 2,455 | 5/15/2015 |
| 1.0.5 | 2,826 | 3/20/2015 |
| 1.0.3 | 3,057 | 2/27/2015 |
| 1.0.0 | 5,508 | 2/6/2015 |