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 (44)
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.1 | 508 | 7/16/2025 |
9.2.0 | 962 | 7/14/2025 |
9.2.0-preview3 | 2,857 | 6/10/2025 |
9.2.0-preview2 | 664 | 6/4/2025 |
9.2.0-preview1 | 7,506 | 4/4/2025 |
9.1.2 | 175,645 | 2/13/2025 |
9.0.1 | 99,286 | 11/23/2024 |
9.0.0 | 9,669 | 11/14/2024 |
8.2.0 | 345,916 | 7/12/2024 |
8.2.0-preview1 | 438 | 5/22/2024 |
8.1.0 | 164,296 | 4/17/2024 |
8.1.0-preview3 | 1,457 | 3/11/2024 |
8.1.0-preview2 | 504 | 2/23/2024 |
8.1.0-preview1 | 307 | 2/13/2024 |
8.0.0 | 137,321 | 1/5/2024 |
8.0.0-rc2 | 483 | 12/20/2023 |
8.0.0-rc1 | 538 | 12/4/2023 |
7.2.7 | 2,725 | 10/15/2024 |
7.2.6 | 34,030 | 3/9/2024 |
7.2.5 | 9,804 | 2/22/2024 |
7.2.4 | 103,285 | 12/2/2023 |
7.2.3 | 57,632 | 11/3/2023 |
7.2.2 | 50,036 | 10/16/2023 |
7.2.1 | 119,492 | 7/11/2023 |
7.2.0 | 8,665 | 7/7/2023 |
7.1.2 | 121,648 | 4/19/2023 |
7.1.1 | 68,925 | 3/23/2023 |
7.1.0 | 92,663 | 2/1/2023 |
7.0.0 | 109,872 | 11/8/2022 |
7.0.0-rc2 | 808 | 10/19/2022 |
4.0.0-preview2 | 9,958 | 8/4/2022 |
4.0.0-preview1 | 6,341 | 2/10/2022 |
3.8.0 | 1,001 | 5/6/2025 |
3.8.0-preview5 | 236 | 5/12/2025 |
3.8.0-preview3 | 214 | 4/8/2025 |
3.8.0-preview2 | 148 | 4/4/2025 |
3.8.0-preview1 | 198 | 3/31/2025 |
3.7.2 | 31,187 | 5/10/2024 |
3.7.1 | 91,067 | 5/27/2023 |
3.7.0 | 11,738 | 3/23/2023 |
3.6.5 | 924,650 | 8/15/2022 |
3.6.4 | 10,431 | 8/10/2022 |
3.6.3 | 46,557 | 8/4/2022 |
3.6.2 | 749,158 | 4/15/2022 |
3.6.1 | 104,486 | 4/5/2022 |
3.6.0 | 180,375 | 1/20/2022 |
3.5.1 | 305,955 | 11/8/2021 |
3.5.0 | 175,350 | 9/3/2021 |
3.4.4 | 11,848 | 10/4/2021 |
3.4.3 | 151,854 | 6/3/2021 |
3.4.2 | 66,136 | 4/5/2021 |
3.4.1 | 134,299 | 2/3/2021 |
3.4.0 | 1,239,613 | 1/6/2021 |
3.4.0-rc1 | 624 | 12/9/2020 |
3.3.0 | 144,443 | 9/9/2020 |
3.3.0-rc2 | 641 | 9/2/2020 |
3.3.0-rc1 | 573 | 8/19/2020 |
3.2.2 | 24,029 | 7/22/2020 |
3.2.1 | 18,123 | 7/2/2020 |
3.2.0 | 85,743 | 6/4/2020 |
3.2.0-rc2 | 3,613 | 5/20/2020 |
3.2.0-rc1 | 925 | 5/7/2020 |
3.1.7 | 26,068 | 5/19/2020 |
3.1.6 | 643,495 | 4/16/2020 |
3.1.5 | 3,180 | 4/9/2020 |
3.1.4 | 10,914 | 3/26/2020 |
3.1.3 | 16,049 | 3/16/2020 |
3.1.2 | 6,389 | 3/5/2020 |
3.1.0 | 13,537 | 2/23/2020 |
3.1.0-rc3 | 873 | 2/13/2020 |
3.1.0-rc2 | 816 | 2/12/2020 |
3.1.0-rc1 | 737 | 2/10/2020 |
3.0.2 | 43,912 | 12/12/2019 |
3.0.1 | 7,351 | 11/27/2019 |
3.0.0 | 202,092 | 10/24/2019 |
3.0.0-rc2 | 1,274 | 10/16/2019 |
3.0.0-rc1 | 902 | 10/9/2019 |
3.0.0-beta1 | 2,030 | 8/16/2019 |
2.4.5 | 14,201 | 12/29/2019 |
2.4.4 | 12,129 | 11/27/2019 |
2.4.3 | 54,629 | 10/10/2019 |
2.4.2 | 137,073 | 8/31/2019 |
2.4.1 | 40,467 | 8/14/2019 |
2.4.0 | 18,183 | 8/8/2019 |
2.3.6 | 15,491 | 7/24/2019 |
2.3.5 | 79,110 | 6/14/2019 |
2.3.4 | 36,390 | 6/4/2019 |
2.3.3 | 3,114 | 6/2/2019 |
2.3.2 | 27,924 | 5/9/2019 |
2.3.1 | 13,156 | 4/26/2019 |
2.3.0 | 78,381 | 3/20/2019 |
2.3.0-rc2 | 1,939 | 3/13/2019 |
2.3.0-rc1 | 985 | 3/4/2019 |
2.2.4 | 13,564 | 2/25/2019 |
2.2.0 | 53,088 | 12/13/2018 |
2.2.0-rc1 | 975 | 12/4/2018 |
2.2.0-beta1 | 1,523 | 10/21/2018 |
2.1.2 | 45,209 | 10/11/2018 |
2.1.0 | 17,118 | 9/28/2018 |
2.1.0-rc2 | 1,625 | 9/21/2018 |
2.1.0-rc1 | 1,537 | 9/14/2018 |
2.1.0-beta1 | 3,084 | 8/27/2018 |
2.0.3 | 69,889 | 5/31/2018 |
2.0.0 | 15,403 | 3/28/2018 |
2.0.0-rc2 | 3,037 | 3/13/2018 |
2.0.0-rc1 | 1,986 | 2/26/2018 |
2.0.0-beta3 | 7,135 | 12/21/2017 |
2.0.0-beta2 | 1,446 | 12/11/2017 |
2.0.0-beta1 | 3,014 | 10/26/2017 |
1.5.10 | 10,219 | 10/10/2019 |
1.5.9 | 974 | 9/1/2019 |
1.5.8 | 1,026 | 5/31/2019 |
1.5.7 | 1,034 | 2/28/2019 |
1.5.6 | 1,829 | 9/28/2018 |
1.5.5 | 1,484 | 9/8/2018 |
1.5.4 | 11,469 | 6/13/2018 |
1.5.3 | 20,683 | 12/9/2017 |
1.5.2 | 10,739 | 10/17/2017 |
1.5.1 | 3,941 | 8/28/2017 |
1.5.0 | 5,490 | 7/6/2017 |
1.5.0-rc | 1,261 | 6/20/2017 |
1.5.0-beta1 | 1,315 | 4/29/2017 |
1.4.2 | 6,258 | 6/9/2017 |
1.4.1 | 7,339 | 3/27/2017 |
1.4.0 | 5,493 | 2/16/2017 |
1.4.0-beta | 1,236 | 2/1/2017 |
1.3.1 | 5,738 | 11/11/2016 |
1.3.0 | 3,956 | 10/12/2016 |
1.3.0-beta2 | 1,543 | 9/24/2016 |
1.3.0-beta1 | 1,848 | 7/28/2016 |
1.2.4 | 2,284 | 10/5/2016 |
1.2.3 | 4,349 | 7/12/2016 |
1.2.2 | 2,335 | 6/14/2016 |
1.2.1 | 2,249 | 5/18/2016 |
1.2.0 | 4,314 | 5/2/2016 |
1.2.0-beta | 1,373 | 4/19/2016 |
1.1.3 | 4,618 | 3/9/2016 |
1.1.2 | 3,449 | 1/20/2016 |
1.1.1 | 2,115 | 1/11/2016 |
1.1.0 | 2,996 | 12/14/2015 |
1.1.0-beta2 | 1,513 | 12/3/2015 |
1.1.0-beta1 | 1,341 | 11/3/2015 |
1.0.10 | 4,681 | 9/22/2015 |
1.0.9 | 4,327 | 7/16/2015 |
1.0.8 | 5,440 | 5/27/2015 |
1.0.7 | 1,913 | 5/15/2015 |
1.0.5 | 2,467 | 3/20/2015 |
1.0.3 | 2,632 | 2/27/2015 |
1.0.0 | 4,780 | 2/6/2015 |