Microsoft.Orleans.Core 9.2.0

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.
 18
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 17
Microsoft.Orleans.Sdk
Microsoft Orleans meta package to bring in the base Orleans packages for all project types.
 16
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 16

.NET 8.0

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