Microsoft.Orleans.Core 10.0.1

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.OrleansTelemetryConsumers.Counters
Microsoft Windows Performance Counters implementation of Orleans Telemetry API.
 3
Microsoft.Orleans.OrleansCodeGenerator
Package Description
 1
Microsoft.Orleans.OrleansHost
Default silo host process that starts a silo as a process.
 1
Microsoft.Orleans.Runtime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 1
Microsoft.Orleans.Server
Referencing this package is necessary for a silo to start.
 1
Microsoft.Orleans.OrleansRuntime
Core runtime library of Microsoft Orleans that hosts and executes grains within a silo.
 1
Microsoft.Orleans.OrleansProviders
Library of built-in persistence and stream providers included in Microsoft Orleans.
 1
Microsoft.Orleans.OrleansAzureUtils
Library of utility types for Microsoft Azure of Microsoft Orleans.
 1
Microsoft.Orleans.Runtime.Abstractions
Library with core types shared between silo and extensions.
 0

.NET 8.0

.NET 10.0

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