.NET
The .NET API is provided as a package compatible with Microsoft® .NET Standard 2.0.
Get the .NET SDK from NuGet:
dotnet add package Diffusion.Client -v 6.11.2
Get the .NET SDK:
https://download.diffusiondata.com/clients/6.11.2/dotnet/diffusion-dotnet-6.11.2.zip
Capabilities
To see the full list of capabilities supported by the .NET API, see Feature support in the Diffusion API.
Support
Platform | Minimum supported versions | Supported transport protocols |
---|---|---|
.NET | Microsoft .NET Standard 2.0 |
WebSocket |
Resources
Using
- Certificates
-
Diffusion™ Cloud .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.
- Obtain the appropriate intermediate certificate from the certificate authority.
You can get the Startcom certificate from the following location: https://www.startssl.com/certs/. The appropriate intermediate certificate is sub.class2.server.ca.pem
- Use the Microsoft Management Console to import the certificate into the Trusted Root Certification Authorities folder. For more information, see https://msdn.microsoft.com/en-us/library/aa738659(v=vs.110).aspx
- Obtain the appropriate intermediate certificate from the certificate authority.
- Writing good callbacks
-
The .NET 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 writing callbacks:
- 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.