How to: Author and manage Dapr streaming subscriptions in the .NET SDK

Mon, 01 Jan 0001 00:00:00 +0000

Let’s create a subscription to a pub/sub topic or queue at using the streaming capability. We’ll use the simple example provided here, for the following demonstration and walk through it as an explainer of how you can configure message handlers at runtime and which do not require an endpoint to be pre-configured. In this guide, you will:

Deploy a .NET Web API application (StreamingSubscriptionExample)
Utilize the Dapr .NET Messaging SDK to subscribe dynamically to a pub/sub topic.

Prerequisites

Dapr CLI
Initialized Dapr environment
.NET 8, .NET 9, or .NET 10 installed
Dapr.Messaging NuGet package installed to your project

Set up the environment

Clone the .NET SDK repo.

DaprPublishSubscribeClient usage

Mon, 01 Jan 0001 00:00:00 +0000

Lifetime management

A DaprPublishSubscribeClient is a version of the Dapr client that is dedicated to interacting with the Dapr Messaging API. It can be registered alongside a DaprClient and other Dapr clients without issue.

It maintains access to networking resources in the form of TCP sockets used to communicate with the Dapr sidecar and implements IAsyncDisposable to support the eager cleanup of resources.

For best performance, create a single long-lived instance of DaprPublishSubscribeClient and provide access to that shared instance throughout your application. DaprPublishSubscribeClient instances are thread-safe and intended to be shared.

Dapr Messaging .NET SDK on Dapr Docs

How to: Author and manage Dapr streaming subscriptions in the .NET SDK

Prerequisites

Set up the environment

DaprPublishSubscribeClient usage

Lifetime management