API is provided as a package compatible with Microsoft® .NET Standard 2.0.
Get the .NET SDK from NuGet:
Use the following .NET
dotnet add package Diffusion.Client -v 6.6.0-preview.1
Table 1. Supported platforms and transport protocols for the
||Minimum supported versions
||Supported transport protocols
||Microsoft .NET Standard 2.0
.NET clients use certificates to validate the security
of their connection to Diffusion Cloud. The client validates the
certificate sent by Diffusion Cloud against the set of certificates
trusted by the .NET Framework.
If the certificate sent by Diffusion Cloud cannot be validated
against any certificates in the set trusted by the .NET Framework, you must set up a trust store for the client and add the appropriate
certificates to that trust store.
Diffusion Cloud uses certificates
provided by the certificate authority Startcom.
- Writing good callbacks
client library invokes callbacks using a
single inbound thread. Callbacks for a
particular session are called in order, one at a time. Consider the following when
- Do not sleep or call blocking operations in a callback. If you do so, other
pending callbacks for the session are delayed. If you must call a blocking
operation, schedule it in a separate application thread.
- You can use the full Diffusion Cloud API to make other
requests to the server. If you want to make many requests based on a single
callback notification, be aware that Diffusion Cloud client
flow control is managed differently in callback threads. Less throttling is
applied and it is easier to overflow the servers by issuing many thousands of
requests. If you have a lot of requests to make, it is better to schedule the work
in an application thread.
- Regular expressions
The .NET client uses a different regular expression
engine to Diffusion Cloud. Some regular expressions in topic
selectors are evaluated on the client and others on Diffusion Cloud.
It is possible that topic selectors that include complex or advanced regular
expressions can behave differently on the client and on Diffusion Cloud.
For more information, see Regular expressions.