Microsoft.Orleans.Client
9.2.0-preview2
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.Orleans.Client --version 9.2.0-preview2
NuGet\Install-Package Microsoft.Orleans.Client -Version 9.2.0-preview2
<PackageReference Include="Microsoft.Orleans.Client" Version="9.2.0-preview2" />
<PackageVersion Include="Microsoft.Orleans.Client" Version="9.2.0-preview2" />
<PackageReference Include="Microsoft.Orleans.Client" />
paket add Microsoft.Orleans.Client --version 9.2.0-preview2
#r "nuget: Microsoft.Orleans.Client, 9.2.0-preview2"
#addin nuget:?package=Microsoft.Orleans.Client&version=9.2.0-preview2&prerelease
#tool nuget:?package=Microsoft.Orleans.Client&version=9.2.0-preview2&prerelease
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.2)
- 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.0-preview2)
- 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 (43)
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 (13)
Showing the top 13 popular GitHub repositories that depend on Microsoft.Orleans.Client:
Repository | Stars |
---|---|
dotnet/aspire
Tools, templates, and packages to accelerate building observable, production-ready apps
|
|
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
|
|
dotnet/dotnet
Home of .NET's Virtual Monolithic Repository which includes all the code needed to build the .NET SDK.
|
|
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.0-preview3 | 348 | 6/10/2025 |
9.2.0-preview2 | 223 | 6/4/2025 |
9.2.0-preview1 | 4,611 | 4/4/2025 |
9.1.2 | 140,175 | 2/13/2025 |
9.0.1 | 94,636 | 11/23/2024 |
9.0.0 | 9,427 | 11/14/2024 |
8.2.0 | 330,317 | 7/12/2024 |
8.2.0-preview1 | 423 | 5/22/2024 |
8.1.0 | 160,964 | 4/17/2024 |
8.1.0-preview3 | 1,445 | 3/11/2024 |
8.1.0-preview2 | 494 | 2/23/2024 |
8.1.0-preview1 | 294 | 2/13/2024 |
8.0.0 | 135,209 | 1/5/2024 |
8.0.0-rc2 | 473 | 12/20/2023 |
8.0.0-rc1 | 527 | 12/4/2023 |
7.2.7 | 2,297 | 10/15/2024 |
7.2.6 | 33,196 | 3/9/2024 |
7.2.5 | 9,698 | 2/22/2024 |
7.2.4 | 101,698 | 12/2/2023 |
7.2.3 | 57,033 | 11/3/2023 |
7.2.2 | 49,969 | 10/16/2023 |
7.2.1 | 118,678 | 7/11/2023 |
7.2.0 | 8,643 | 7/7/2023 |
7.1.2 | 121,146 | 4/19/2023 |
7.1.1 | 68,905 | 3/23/2023 |
7.1.0 | 92,532 | 2/1/2023 |
7.0.0 | 109,192 | 11/8/2022 |
7.0.0-rc2 | 791 | 10/19/2022 |
4.0.0-preview2 | 9,937 | 8/4/2022 |
4.0.0-preview1 | 6,321 | 2/10/2022 |
3.8.0 | 655 | 5/6/2025 |
3.8.0-preview5 | 225 | 5/12/2025 |
3.8.0-preview3 | 203 | 4/8/2025 |
3.8.0-preview2 | 135 | 4/4/2025 |
3.8.0-preview1 | 185 | 3/31/2025 |
3.7.2 | 29,809 | 5/10/2024 |
3.7.1 | 89,327 | 5/27/2023 |
3.7.0 | 11,666 | 3/23/2023 |
3.6.5 | 921,348 | 8/15/2022 |
3.6.4 | 10,374 | 8/10/2022 |
3.6.3 | 46,464 | 8/4/2022 |
3.6.2 | 748,343 | 4/15/2022 |
3.6.1 | 104,460 | 4/5/2022 |
3.6.0 | 179,752 | 1/20/2022 |
3.5.1 | 304,691 | 11/8/2021 |
3.5.0 | 175,151 | 9/3/2021 |
3.4.4 | 11,828 | 10/4/2021 |
3.4.3 | 150,678 | 6/3/2021 |
3.4.2 | 66,090 | 4/5/2021 |
3.4.1 | 134,212 | 2/3/2021 |
3.4.0 | 1,215,562 | 1/6/2021 |
3.4.0-rc1 | 604 | 12/9/2020 |
3.3.0 | 144,195 | 9/9/2020 |
3.3.0-rc2 | 622 | 9/2/2020 |
3.3.0-rc1 | 557 | 8/19/2020 |
3.2.2 | 23,870 | 7/22/2020 |
3.2.1 | 18,065 | 7/2/2020 |
3.2.0 | 85,711 | 6/4/2020 |
3.2.0-rc2 | 3,279 | 5/20/2020 |
3.2.0-rc1 | 905 | 5/7/2020 |
3.1.7 | 25,796 | 5/19/2020 |
3.1.6 | 640,838 | 4/16/2020 |
3.1.5 | 3,162 | 4/9/2020 |
3.1.4 | 10,893 | 3/26/2020 |
3.1.3 | 16,022 | 3/16/2020 |
3.1.2 | 6,367 | 3/5/2020 |
3.1.0 | 13,515 | 2/23/2020 |
3.1.0-rc3 | 851 | 2/13/2020 |
3.1.0-rc2 | 794 | 2/12/2020 |
3.1.0-rc1 | 717 | 2/10/2020 |
3.0.2 | 43,840 | 12/12/2019 |
3.0.1 | 7,332 | 11/27/2019 |
3.0.0 | 201,957 | 10/24/2019 |
3.0.0-rc2 | 1,250 | 10/16/2019 |
3.0.0-rc1 | 880 | 10/9/2019 |
3.0.0-beta1 | 2,006 | 8/16/2019 |
2.4.5 | 14,124 | 12/29/2019 |
2.4.4 | 12,109 | 11/27/2019 |
2.4.3 | 54,602 | 10/10/2019 |
2.4.2 | 136,792 | 8/31/2019 |
2.4.1 | 39,932 | 8/14/2019 |
2.4.0 | 18,018 | 8/8/2019 |
2.3.6 | 15,457 | 7/24/2019 |
2.3.5 | 79,053 | 6/14/2019 |
2.3.4 | 36,272 | 6/4/2019 |
2.3.3 | 3,092 | 6/2/2019 |
2.3.2 | 27,900 | 5/9/2019 |
2.3.1 | 13,133 | 4/26/2019 |
2.3.0 | 78,293 | 3/20/2019 |
2.3.0-rc2 | 1,921 | 3/13/2019 |
2.3.0-rc1 | 967 | 3/4/2019 |
2.2.4 | 13,512 | 2/25/2019 |
2.2.0 | 53,051 | 12/13/2018 |
2.2.0-rc1 | 954 | 12/4/2018 |
2.2.0-beta1 | 1,499 | 10/21/2018 |
2.1.2 | 45,165 | 10/11/2018 |
2.1.0 | 17,072 | 9/28/2018 |
2.1.0-rc2 | 1,588 | 9/21/2018 |
2.1.0-rc1 | 1,499 | 9/14/2018 |
2.1.0-beta1 | 3,041 | 8/27/2018 |
2.0.3 | 69,823 | 5/31/2018 |
2.0.0 | 15,338 | 3/28/2018 |
2.0.0-rc2 | 2,977 | 3/13/2018 |
2.0.0-rc1 | 1,926 | 2/26/2018 |
2.0.0-beta3 | 7,077 | 12/21/2017 |
2.0.0-beta2 | 1,408 | 12/11/2017 |
2.0.0-beta1 | 2,972 | 10/26/2017 |
1.5.10 | 10,166 | 10/10/2019 |
1.5.9 | 952 | 9/1/2019 |
1.5.8 | 1,008 | 5/31/2019 |
1.5.7 | 1,011 | 2/28/2019 |
1.5.6 | 1,792 | 9/28/2018 |
1.5.5 | 1,442 | 9/8/2018 |
1.5.4 | 11,425 | 6/13/2018 |
1.5.3 | 19,898 | 12/9/2017 |
1.5.2 | 10,692 | 10/17/2017 |
1.5.1 | 3,882 | 8/28/2017 |
1.5.0 | 5,417 | 7/6/2017 |
1.5.0-rc | 1,221 | 6/20/2017 |
1.5.0-beta1 | 1,275 | 4/29/2017 |
1.4.2 | 6,217 | 6/9/2017 |
1.4.1 | 7,259 | 3/27/2017 |
1.4.0 | 5,450 | 2/16/2017 |
1.4.0-beta | 1,198 | 2/1/2017 |
1.3.1 | 5,681 | 11/11/2016 |
1.3.0 | 3,911 | 10/12/2016 |
1.3.0-beta2 | 1,500 | 9/24/2016 |
1.3.0-beta1 | 1,808 | 7/28/2016 |
1.2.4 | 2,243 | 10/5/2016 |
1.2.3 | 4,307 | 7/12/2016 |
1.2.2 | 2,289 | 6/14/2016 |
1.2.1 | 2,207 | 5/18/2016 |
1.2.0 | 4,270 | 5/2/2016 |
1.2.0-beta | 1,328 | 4/19/2016 |
1.1.3 | 4,556 | 3/9/2016 |
1.1.2 | 3,404 | 1/20/2016 |
1.1.1 | 2,072 | 1/11/2016 |
1.1.0 | 2,955 | 12/14/2015 |
1.1.0-beta2 | 1,472 | 12/3/2015 |
1.1.0-beta1 | 1,301 | 11/3/2015 |
1.0.10 | 4,616 | 9/22/2015 |
1.0.9 | 4,284 | 7/16/2015 |
1.0.8 | 5,401 | 5/27/2015 |
1.0.7 | 1,857 | 5/15/2015 |
1.0.5 | 2,430 | 3/20/2015 |
1.0.3 | 2,589 | 2/27/2015 |
1.0.0 | 4,699 | 2/6/2015 |