Question 1

How to migrate from NATS .NET V1 to V2?

Accepted Answer

The README directs new projects to V2, which supports only async I/O and targets .NET 6+. For migration, review the V2 repository and update code to use async patterns, as V2 has a different API focused on modern .NET features and may require significant refactoring.

Question 2

NATS .NET V1 vs V2: which one should I use?

Accepted Answer

Use V1 only for maintaining existing .NET Framework 4.6+ or .NET Standard 1.6 applications. For new projects, V2 is recommended due to its async-only design, support for current .NET LTS releases, and active development, as V1 is deprecated.

Question 3

How to set up JetStream with NATS .NET V1?

Accepted Answer

Create a JetStream context from the connection using IConnection.CreateJetStreamContext(), then use publish and subscribe methods with options like PushSubscribeOptions or PullSubscribeOptions. The README includes examples for synchronous/asynchronous publishing and various subscription types.

Question 4

Why am I getting subject validation errors in NATS .NET V1?

Accepted Answer

Version 1.1.0 introduced stricter validation to match NATS server 2.10, requiring subjects without spaces, no leading/trailing '.', and no empty segments. Check your subject names and filters, as mismatches can throw exceptions like '90011 Subject does not match consumer configuration filter'.

Question 5

Can I use Reactive Extensions (Rx) with NATS .NET V1?

Accepted Answer

Yes, by importing the NATS.Client.Rx namespace, you can use extension methods like connection.Observe(subject) to turn connections into observables, with built-in ops for filtering and selecting, as demonstrated in the RxSample example.

Question 6

How to handle TLS for secure connections in NATS .NET V1?

Accepted Answer

Set the Secure option to true in Options, add an X509Certificate2 with private key and certificate in the same file (e.g., .pfx), and optionally override TLSRemoteCertificationValidationCallback for custom validation, as shown in the TlsVariationsExample.

csharp-nats

What is csharp-nats?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions