Microsoft.Orleans.Client
10.1.0
Prefix Reserved
dotnet add package Microsoft.Orleans.Client --version 10.1.0
NuGet\Install-Package Microsoft.Orleans.Client -Version 10.1.0
<PackageReference Include="Microsoft.Orleans.Client" Version="10.1.0" />
<PackageVersion Include="Microsoft.Orleans.Client" Version="10.1.0" />
<PackageReference Include="Microsoft.Orleans.Client" />
paket add Microsoft.Orleans.Client --version 10.1.0
#r "nuget: Microsoft.Orleans.Client, 10.1.0"
#:package Microsoft.Orleans.Client@10.1.0
#addin nuget:?package=Microsoft.Orleans.Client&version=10.1.0
#tool nuget:?package=Microsoft.Orleans.Client&version=10.1.0
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.
-
net10.0
- Microsoft.AspNetCore.Connections.Abstractions (>= 10.0.3)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.0)
- Microsoft.CodeAnalysis.Common (>= 5.0.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 5.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.3)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.3)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.3)
- Microsoft.Extensions.Configuration.Json (>= 10.0.3)
- Microsoft.Extensions.DependencyInjection (>= 10.0.3)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.3)
- Microsoft.Extensions.DependencyModel (>= 10.0.3)
- Microsoft.Extensions.Hosting (>= 10.0.3)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.3)
- Microsoft.Extensions.Logging (>= 10.0.3)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.3)
- Microsoft.Extensions.Logging.Console (>= 10.0.3)
- Microsoft.Extensions.Logging.Debug (>= 10.0.3)
- Microsoft.Extensions.ObjectPool (>= 10.0.3)
- Microsoft.Extensions.Options (>= 10.0.3)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.3)
- Microsoft.Orleans.Sdk (>= 10.1.0)
- Newtonsoft.Json (>= 13.0.4)
- System.IO.Hashing (>= 10.0.3)
- System.Memory.Data (>= 10.0.3)
-
net8.0
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.24)
- 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.24)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Microsoft.Orleans.Sdk (>= 10.1.0)
- Newtonsoft.Json (>= 13.0.4)
- System.IO.Hashing (>= 10.0.3)
- System.IO.Pipelines (>= 8.0.0)
- System.Memory.Data (>= 8.0.1)
NuGet packages (47)
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 |
|---|---|
|
microsoft/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.
|
|
|
usnistgov/ACVP-Server
A repository tracking releases of NIST's ACVP server. See www.github.com/usnistgov/ACVP for the protocol.
|
| Version | Downloads | Last Updated |
|---|---|---|
| 10.1.0 | 8,443 | 4/14/2026 |
| 10.0.1 | 93,278 | 2/7/2026 |
| 10.0.0 | 22,979 | 1/20/2026 |
| 10.0.0-rc.2 | 3,957 | 12/31/2025 |
| 9.2.1 | 354,893 | 7/16/2025 |
| 9.2.0 | 5,381 | 7/14/2025 |
| 9.2.0-preview3 | 11,805 | 6/10/2025 |
| 9.2.0-preview2 | 987 | 6/4/2025 |
| 9.2.0-preview1 | 8,811 | 4/4/2025 |
| 9.1.2 | 321,721 | 2/13/2025 |
| 9.0.1 | 132,566 | 11/23/2024 |
| 9.0.0 | 15,940 | 11/14/2024 |
| 3.8.1 | 109 | 4/24/2026 |
| 3.8.0 | 14,027 | 5/6/2025 |
| 3.8.0-preview5 | 564 | 5/12/2025 |
| 3.8.0-preview3 | 554 | 4/8/2025 |
| 3.8.0-preview2 | 476 | 4/4/2025 |
| 3.8.0-preview1 | 518 | 3/31/2025 |