Microsoft.Orleans.Core 9.2.0-preview2

Microsoft Orleans Core Library

Introduction

Microsoft Orleans Core is the primary library used by both client and server applications. It provides the runtime components necessary for Orleans applications, including serialization, communication, and the core hosting infrastructure.

Getting Started

To use this package, install it via NuGet:

dotnet add package Microsoft.Orleans.Core

This package is automatically included when you reference the Orleans SDK or the Orleans client/server metapackages.

Example - Configuring a Client

using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Orleans;
using Orleans.Configuration;
using System;
using System.Threading.Tasks;

// Define a grain interface
namespace MyGrainNamespace;

public interface IHelloGrain : IGrainWithStringKey
{
    Task<string> SayHello(string greeting);
}

// Implement the grain interface
public class HelloGrain : Grain, IHelloGrain
{
    public Task<string> SayHello(string greeting)
    {
        return Task.FromResult($"Hello! I got: {greeting}");
    }
}

// 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 grain = host.Services.GetRequiredService<IClusterClient>().GetGrain<IHelloGrain>("grain-id");
var response = await grain.SayHello("Hello from client!");

// Print the result
Console.WriteLine($"Response: {response}");

// Keep the host running until the application is shut down
await host.WaitForShutdownAsync();

Documentation

For more comprehensive documentation, please refer to:

Feedback & Contributing

Showing the top 20 packages that depend on Microsoft.Orleans.Core.

Packages Downloads
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 22
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 21
Microsoft.Orleans.Sdk
Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
 21
Microsoft.Orleans.Sdk
Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
 20
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 20
Microsoft.Orleans.Sdk
Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
 19

.NET 8.0

Version Downloads Last updated
9.2.1 6 07/19/2025
9.2.0 7 07/16/2025
9.2.0-preview3 8 06/14/2025
9.2.0-preview2 7 06/07/2025
9.2.0-preview1 13 04/12/2025
9.1.2 13 02/17/2025
9.1.1 13 02/16/2025
9.1.0 13 02/16/2025
9.0.1 14 11/27/2024
9.0.0 17 11/30/2024
8.2.0 21 09/13/2024
8.2.0-preview1 19 10/02/2024
8.1.0 13 11/30/2024
8.1.0-preview3 19 11/26/2024
8.1.0-preview2 18 10/02/2024
8.1.0-preview1 19 11/30/2024
8.0.0 15 04/04/2024
8.0.0-rc2 15 10/05/2024
8.0.0-rc1 15 11/19/2024
7.2.7 15 11/30/2024
7.2.6 16 10/03/2024
7.2.5 17 10/10/2024
7.2.4 18 11/30/2024
7.2.3 17 10/30/2024
7.2.2 19 10/05/2024
7.2.1 18 10/05/2024
7.2.0 16 09/26/2024
7.1.2 18 10/05/2024
7.1.1 14 10/04/2024
7.1.0 15 11/30/2024
7.0.0 19 11/30/2024
7.0.0-rc2 15 11/19/2024
4.0.0-preview2 16 10/05/2024
4.0.0-preview1 18 10/04/2024
3.8.0 13 05/10/2025
3.8.0-preview5 13 05/17/2025
3.8.0-preview3 13 04/13/2025
3.8.0-preview2 12 04/14/2025
3.8.0-preview1 12 04/09/2025
3.7.2 16 10/05/2024
3.7.1 20 11/30/2024
3.7.0 16 11/22/2024
3.6.5 18 11/30/2024
3.6.4 18 11/18/2024
3.6.3 17 10/03/2024
3.6.2 16 10/04/2024
3.6.1 16 10/13/2024
3.6.0 17 10/05/2024
3.5.1 14 10/04/2024
3.5.0 17 11/21/2024
3.4.4 17 11/30/2024
3.4.3 15 11/30/2024
3.4.2 18 10/05/2024
3.4.1 16 10/05/2024
3.4.0 16 11/06/2024
3.4.0-rc1 16 10/02/2024
3.3.0 17 11/30/2024
3.3.0-rc2 17 11/19/2024
3.3.0-rc1 17 11/19/2024
3.2.2 17 09/19/2024
3.2.1 18 10/05/2024
3.2.0 18 09/22/2024
3.2.0-rc2 19 11/19/2024
3.2.0-rc1 13 11/19/2024
3.1.7 16 11/30/2024
3.1.6 17 10/05/2024
3.1.5 16 10/04/2024
3.1.4 18 10/03/2024
3.1.3 18 10/03/2024
3.1.2 21 10/03/2024
3.1.0 20 10/05/2024
3.1.0-rc3 20 10/05/2024
3.1.0-rc2 17 10/04/2024
3.1.0-rc1 18 10/05/2024
3.0.2 18 10/05/2024
3.0.1 18 10/05/2024
3.0.0 19 10/07/2024
3.0.0-rc2 18 11/19/2024
3.0.0-rc1 20 10/05/2024
3.0.0-beta1 15 10/06/2024
2.4.5 19 10/03/2024
2.4.4 18 10/02/2024
2.4.3 14 10/04/2024
2.4.2 17 10/06/2024
2.4.1 15 11/30/2024
2.4.0 16 10/05/2024
2.3.6 16 11/30/2024
2.3.5 17 11/30/2024
2.3.4 15 11/30/2024
2.3.3 16 10/29/2024
2.3.2 17 11/30/2024
2.3.1 15 11/30/2024
2.3.0 17 10/05/2024
2.3.0-rc2 15 11/19/2024
2.3.0-rc1 17 11/19/2024
2.2.4 17 11/30/2024
2.2.0 18 10/05/2024
2.2.0-rc1 18 10/03/2024
2.2.0-beta1 17 11/30/2024
2.1.2 17 11/30/2024
2.1.0 16 10/04/2024
2.1.0-rc2 14 10/05/2024
2.1.0-rc1 18 11/19/2024
2.1.0-beta1 16 11/30/2024
2.0.3 16 11/28/2024
2.0.0 19 10/05/2024
2.0.0-rc2 19 10/05/2024
2.0.0-rc1 18 10/04/2024
2.0.0-beta3 18 10/05/2024
2.0.0-beta2 15 11/02/2024
2.0.0-beta1 18 10/05/2024
1.5.10 17 10/04/2024
1.5.9 17 10/28/2024
1.5.8 15 11/30/2024
1.5.7 17 11/30/2024
1.5.6 16 11/30/2024
1.5.5 17 10/03/2024
1.5.4 18 10/05/2024
1.5.3 17 11/30/2024
1.5.2 20 11/24/2024
1.5.1 15 11/30/2024
1.5.0 18 11/30/2024
1.5.0-rc 17 10/05/2024
1.5.0-beta1 16 10/02/2024
1.4.2 14 11/03/2024
1.4.1 15 11/30/2024
1.4.0 15 11/30/2024
1.4.0-beta 15 10/04/2024
1.3.1 17 11/17/2024
1.3.0 12 10/04/2024
1.3.0-beta2 18 10/05/2024
1.3.0-beta1 15 10/05/2024
1.2.4 18 10/04/2024
1.2.3 15 11/30/2024
1.2.2 15 11/30/2024
1.2.1 15 11/30/2024
1.2.0 19 10/05/2024
1.2.0-beta 17 10/04/2024
1.1.3 20 10/05/2024
1.1.2 16 11/30/2024
1.1.1 17 11/30/2024
1.1.0 17 11/30/2024
1.1.0-beta2 17 11/30/2024
1.1.0-beta1 14 11/30/2024
1.0.10 17 11/30/2024
1.0.9 12 11/30/2024
1.0.8 12 11/30/2024
1.0.7 18 10/05/2024
1.0.5 12 11/30/2024
1.0.3 17 11/30/2024
1.0.0 15 11/30/2024