nanoFramework.System.Net.Http 1.5.150

Prefix Reserved
dotnet add package nanoFramework.System.Net.Http --version 1.5.150                
NuGet\Install-Package nanoFramework.System.Net.Http -Version 1.5.150                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.System.Net.Http" Version="1.5.150" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.System.Net.Http --version 1.5.150                
#r "nuget: nanoFramework.System.Net.Http, 1.5.150"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.System.Net.Http as a Cake Addin
#addin nuget:?package=nanoFramework.System.Net.Http&version=1.5.150

// Install nanoFramework.System.Net.Http as a Cake Tool
#tool nuget:?package=nanoFramework.System.Net.Http&version=1.5.150                

Quality Gate Status Reliability Rating License NuGet #yourfirstpr Discord

nanoFramework logo


Welcome to the .NET nanoFramework System.Net.Http Library repository

Build status

Component Build Status NuGet Package
System.Net.Http Build Status NuGet
System.Net.Http.Client Build Status NuGet
System.Net.Http.Server Build Status NuGet

Usage examples

The API, classes and namespaces in this library follow, as close as possible, the .NET ones. Exceptions are the lack of async calls, generics and the Task, async/await model. The names reflect that by dropping the Async suffix and not returning Task and the lack of the overloaded methods with CancelationToken parameters.

Also worth mentioning is the need to pass the CA root certificate to HttpClient in order to be able to validate the server certificate.

HttpClient calling REST services

HttpClient makes it very easy to connect and consume REST services. In order to use it, one has to create the object and them perform the calls. Note that HttpClient is meant to be reused throughout the application lifecycle. There is no need to create a new instance every time a call has to be performed. Like this:

static readonly HttpClient _httpClient = new HttpClient();

To pass the CA root certificate allowing to validate the secure server certificate. The CA root cert can also come from a binary file or text file from a resource.

_httpClient.HttpsAuthentCert = new X509Certificate(
@"-----BEGIN CERTIFICATE-----
MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
+lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
-----END CERTIFICATE-----");

[!Note]

In order to get a root certificate from a server, if you install OpenSSL, you can run the following command: openssl s_client -connect the.server-to-get-the-cert.com:443 -showcerts This will show you all the root certs used and present them as PEM. You can then copy/paste the one you need.

It's possible to add HTTP headers that will be sent along with each request.

_httpClient.DefaultRequestHeaders.Add("x-ms-blob-type", "BlockBlob");

Perform a HTTP GET request

Here's a example of a HTTP request to read some content as a string:

HttpResponseMessage response = _httpClient.Get("https://httpbin.org/get");
response.EnsureSuccessStatusCode();
var responseBody = response.Content.ReadAsString();

The above call would return something similar to the following, which can be output in Visual Studio by calling Debug.WriteLine(responseBody):

{
  "args": {}, 
  "headers": {
    "Host": "httpbin.org", 
    "X-Amzn-Trace-Id": "Root=1-6214aad3-38e5f8357bdf90530300eb5f", 
    "X-Ms-Blob-Type": "BlockBlob"
  }, 
  "origin": "5.249.47.208", 
  "url": "https://httpbin.org/get"
}

Note the call to response.EnsureSuccessStatusCode();. This will throw an HttpRequestException in case the status code from the HTTP request is not a successful one.

Perform a HTTP POST request

Follows an example of a HTTP request performing POST request to send some json content to an endpoint.

var content = new StringContent("{\"someProperty\":\"someValue\"}", Encoding.UTF8, "application/json");
var result = _httpClient.Post("https://httpbin.org/anything", content);
result.EnsureSuccessStatusCode();

Worth noting that the json content above it's presented as a simple string to simplify the code. There is a json library available to help with serializing and deserializing from/to C# classes, even the most complex ones.

Again, note the call to response.EnsureSuccessStatusCode(); to make sure the HTTP request was successfully performed.

Download binary content to a file

Using HttpClient makes it easy to deal with binary content too. Here's an example of how to download a file from a webserver.

HttpResponseMessage response = _httpClient.Get("https://storage-on-the-cloud.net/file-with-binary-content");
response.EnsureSuccessStatusCode();

using FileStream fs = new FileStream($"I:\\i-am-a-binary-file.bin", FileMode.Create, FileAccess.Write);
response.Content.ReadAsStream().CopyTo(fs);

Disposing the response

[!Important] You MUST dispose the response sent but any of the request. The device memory is limited and the response content will never be disposed if not asked. Depending on the devices, you may have only 16 possible requests before you'll get an out of memory.

Here is few right patterns to make sure you'll dispose properly the response content:

using HttpResponseMessage response = client.Get(apiUrl);
// do whatever you want
// When the response object won't be used, it will be disposed

You can as well have an explicit using for a block:

using HttpResponseMessage response = client.Get(apiUrl)
{
  // do whatever you want
  // when exiting the block, the response will be disposed
}

Or explicitly dispose the response:

HttpResponseMessage response = client.Get(apiUrl);
// do whatever you want
// Dispose explicitly the content
response.Dispose();

In all cases, you MUST make ure you are disposing the response content.

Debugging through a reverse proxy

When code is deployed to a MCU it might be desirable to let the device connect to your development machine running IIS Express. This can be achieved with a proxy such as this one. Be aware that this leads to SocketExceptions with the current version of nanoFramework System.Net.Http when sending consecutive requests to your development machine. A simple retry mechanism in Debug mode will get around this.

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.

Credits

The list of contributors to this project can be found at CONTRIBUTORS.

License

The nanoFramework Class Libraries are licensed under the MIT license.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (14)

Showing the top 5 NuGet packages that depend on nanoFramework.System.Net.Http:

Package Downloads
nanoFramework.Azure.Devices.Client

This package includes the .NET nanoFramework.Azure.Devices.Client assembly for .NET nanoFramework C# projects. This is an SDK for Azure IoT Hub using MQTT broker.

nanoFramework.System.Net.WebSockets

This package includes the System.Net.WebSockets assembly for nanoFramework C# projects. There are also two other packages with just the client API and just the server API. These are meant to be used when there is the need to use smaller assemblies.

nanoFramework.System.Net.WebSockets.Server

This package includes the System.Net.WebSockets assembly (server API only) for .NET nanoFramework C# projects. There are also two other packages, one with the client API only and another with the complete API.

MakoIoT.Device.Services.ConfigurationManager

Configuration mode manager for MAKO-IoT

MakoIoT.Device.Services.Server

Simple WebServer for .NET nanoFramework C# projects. Based on nanoFramework.WebServer by Laurent Ellerbach and contributors

GitHub repositories (3)

Showing the top 3 popular GitHub repositories that depend on nanoFramework.System.Net.Http:

Repository Stars
dotnet/samples
Sample code referenced by the .NET documentation
nanoframework/Samples
🍬 Code samples from the nanoFramework team used in testing, proof of concepts and other explorational endeavours
nanoframework/nanoFramework.IoT.Device
📦 This repo includes .NET nanoFramework implementations for various sensors, chips, displays, hats and drivers
Version Downloads Last updated
1.5.150 842 9/26/2024
1.5.145 3,342 7/30/2024
1.5.138 4,426 5/13/2024
1.5.136 629 5/10/2024
1.5.134 1,902 4/8/2024
1.5.132 522 4/8/2024
1.5.130 859 4/3/2024
1.5.128 237 4/3/2024
1.5.125 3,356 1/29/2024
1.5.118 1,732 1/24/2024
1.5.113 8,266 11/10/2023
1.5.110 137 11/9/2023
1.5.108 951 11/9/2023
1.5.106 1,637 11/3/2023
1.5.104 2,146 10/10/2023
1.5.102 2,516 10/4/2023
1.5.99 4,377 8/8/2023
1.5.97 880 7/27/2023
1.5.95 227 7/27/2023
1.5.84 5,852 2/17/2023
1.5.82 1,921 1/24/2023
1.5.78 2,689 12/28/2022
1.5.75 525 12/28/2022
1.5.73 511 12/28/2022
1.5.70 1,727 12/27/2022
1.5.68 446 12/22/2022
1.5.61 2,699 11/23/2022
1.5.54 3,515 10/26/2022
1.5.52 2,345 10/26/2022
1.5.50 1,913 10/26/2022
1.5.48 2,147 10/25/2022
1.5.45 952 10/25/2022
1.5.43 2,378 10/24/2022
1.5.41 969 10/24/2022
1.5.39 431 10/24/2022
1.5.37 2,231 10/23/2022
1.5.35 435 10/23/2022
1.5.30 3,367 10/10/2022
1.5.27 3,639 10/8/2022
1.5.24 4,032 9/22/2022
1.5.22 4,178 9/22/2022
1.5.20 3,890 9/15/2022
1.5.18 1,029 9/15/2022
1.5.13 3,198 8/5/2022
1.5.10 3,847 8/4/2022
1.5.8 758 8/4/2022
1.5.6 976 8/4/2022
1.5.4 2,312 8/3/2022
1.5.2 1,026 8/3/2022
1.4.0.25 738 8/3/2022
1.4.0.23 3,576 6/13/2022
1.4.0.21 2,621 6/8/2022
1.4.0.19 2,245 6/8/2022
1.4.0.14 2,429 5/26/2022
1.4.0.12 4,478 5/18/2022
1.4.0.10 4,241 5/3/2022
1.4.0 4,380 3/28/2022
1.4.0-preview.52 144 3/28/2022
1.4.0-preview.51 142 3/28/2022
1.4.0-preview.50 143 3/28/2022
1.4.0-preview.48 143 3/28/2022
1.4.0-preview.47 149 3/28/2022
1.4.0-preview.46 147 3/28/2022
1.4.0-preview.44 196 3/17/2022
1.4.0-preview.43 140 3/17/2022
1.4.0-preview.42 182 3/14/2022
1.4.0-preview.41 145 3/14/2022
1.4.0-preview.40 133 3/14/2022
1.4.0-preview.39 148 3/14/2022
1.4.0-preview.37 143 3/14/2022
1.4.0-preview.36 236 3/8/2022
1.4.0-preview.35 160 3/8/2022
1.4.0-preview.33 158 3/4/2022
1.4.0-preview.32 137 3/3/2022
1.4.0-preview.31 144 3/2/2022
1.4.0-preview.29 194 2/28/2022
1.4.0-preview.28 231 2/24/2022
1.4.0-preview.26 188 2/17/2022
1.4.0-preview.24 158 2/17/2022
1.4.0-preview.22 236 2/6/2022
1.4.0-preview.21 176 2/4/2022
1.4.0-preview.19 152 2/4/2022
1.4.0-preview.18 215 1/28/2022
1.4.0-preview.16 149 1/28/2022
1.4.0-preview.15 151 1/28/2022
1.4.0-preview.13 150 1/28/2022
1.4.0-preview.12 174 1/21/2022
1.4.0-preview.6 264 1/12/2022
1.4.0-preview.5 145 1/12/2022
1.4.0-preview.4 160 1/11/2022
1.4.0-preview.3 151 1/11/2022
1.3.7-preview.8 182 1/5/2022
1.3.7-preview.7 180 1/3/2022
1.3.7-preview.6 156 1/3/2022
1.3.7-preview.5 150 1/3/2022
1.3.7-preview.4 170 12/30/2021
1.3.7-preview.3 165 12/28/2021
1.3.6 756 12/3/2021
1.3.6-preview.23 172 12/3/2021
1.3.6-preview.21 152 12/3/2021
1.3.6-preview.20 172 12/2/2021
1.3.6-preview.19 152 12/2/2021
1.3.6-preview.18 164 12/2/2021
1.3.6-preview.17 169 12/2/2021
1.3.6-preview.16 157 12/2/2021
1.3.6-preview.14 160 12/2/2021
1.3.6-preview.12 153 12/2/2021
1.3.6-preview.10 173 12/1/2021
1.3.6-preview.7 156 12/1/2021
1.3.6-preview.1 332 11/11/2021
1.3.5-preview.8 287 10/22/2021
1.3.5-preview.5 205 10/18/2021
1.3.4 1,519 7/16/2021
1.3.4-preview.78 165 7/16/2021
1.3.4-preview.76 166 7/16/2021
1.3.4-preview.74 162 7/16/2021
1.3.4-preview.72 176 7/15/2021
1.3.4-preview.70 181 7/14/2021
1.3.4-preview.68 697 6/19/2021
1.3.4-preview.66 266 6/19/2021
1.3.4-preview.64 185 6/17/2021
1.3.4-preview.62 211 6/7/2021
1.3.4-preview.60 172 6/7/2021
1.3.4-preview.58 206 6/7/2021
1.3.4-preview.56 211 6/6/2021
1.3.4-preview.54 230 6/3/2021
1.3.4-preview.52 178 6/2/2021
1.3.4-preview.50 186 6/1/2021
1.3.4-preview.48 188 6/1/2021
1.3.4-preview.41 209 5/25/2021
1.3.4-preview.39 234 5/21/2021
1.3.4-preview.37 236 5/20/2021
1.3.4-preview.35 181 5/19/2021
1.3.4-preview.33 182 5/19/2021
1.3.4-preview.31 192 5/19/2021
1.3.4-preview.29 173 5/15/2021
1.3.4-preview.27 174 5/15/2021
1.3.4-preview.25 170 5/15/2021
1.3.4-preview.23 195 5/13/2021
1.3.4-preview.22 187 5/13/2021
1.3.4-preview.20 195 5/11/2021
1.3.4-preview.18 240 5/6/2021
1.3.4-preview.16 164 5/6/2021
1.3.4-preview.14 157 5/5/2021
1.3.4-preview.13 159 5/5/2021
1.3.4-preview.10 219 4/10/2021
1.3.4-preview.9 218 4/9/2021
1.3.4-preview.7 197 4/5/2021
1.3.3-preview.65 251 3/20/2021
1.3.3-preview.62 206 3/19/2021
1.3.3-preview.60 170 3/17/2021
1.3.3-preview.57 176 3/17/2021
1.3.3-preview.55 209 3/2/2021
1.3.3-preview.50 408 1/19/2021
1.3.3-preview.47 211 1/6/2021
1.3.3-preview.40 193 12/29/2020
1.3.3-preview.34 263 12/7/2020
1.3.3-preview.32 223 12/7/2020
1.3.3-preview.27 271 11/3/2020
1.3.3-preview.25 243 10/26/2020
1.3.3-preview.23 269 10/21/2020
1.3.3-preview.17 263 10/20/2020
1.3.3-preview.15 320 10/1/2020
1.3.3-preview.11 240 9/30/2020
1.3.3-preview.9 243 9/30/2020
1.3.3-preview.7 269 9/27/2020
1.3.3-preview.5 279 9/27/2020
1.3.3-preview.1 241 9/24/2020
1.3.2-preview.3 267 9/19/2020
1.3.2-preview.1 338 8/25/2020
1.3.1-preview.6 283 7/2/2020
1.3.1-preview.3 318 6/30/2020
1.3.0 781 6/16/2020
1.3.0-rc.3 296 6/16/2020
1.3.0-preview.11 297 6/16/2020
1.3.0-preview.9 245 6/16/2020
1.3.0-preview.7 240 6/16/2020
1.3.0-alpha.12 296 6/16/2020
1.3.0-alpha.10 231 6/16/2020
1.3.0-alpha.8 248 6/16/2020
1.2.2 491 6/12/2020
1.2.2-preview.41 244 6/12/2020
1.2.2-preview.39 258 6/12/2020
1.2.2-preview.34 265 6/3/2020
1.2.2-preview.33 274 6/3/2020
1.2.2-preview.31 372 5/31/2020
1.2.2-preview.30 262 5/31/2020
1.2.2-preview.29 285 5/31/2020
1.2.2-preview.28 268 5/29/2020
1.2.2-preview.27 301 5/8/2020
1.2.2-preview.26 269 5/8/2020
1.2.2-preview.25 278 4/27/2020
1.2.2-preview.24 261 4/24/2020
1.2.2-preview.23 241 4/21/2020
1.2.2-preview.22 293 4/16/2020
1.2.2-preview.19 292 4/16/2020
1.2.2-preview.18 254 4/14/2020
1.2.2-preview.17 261 4/14/2020
1.2.2-preview.16 251 4/14/2020
1.2.2-preview.15 304 3/25/2020
1.2.2-preview.14 306 3/15/2020
1.2.2-preview.13 257 3/10/2020
1.2.2-preview.12 263 3/10/2020
1.2.2-preview.10 246 3/10/2020
1.2.2-preview.8 256 3/10/2020
1.2.2-preview.7 254 3/10/2020
1.2.2-preview.6 280 3/9/2020
1.2.2-preview.5 281 3/9/2020
1.2.2-preview.4 272 3/6/2020
1.2.2-preview.3 336 1/13/2020
1.2.2-preview.2 337 11/14/2019
1.2.2-preview.1 279 11/12/2019
1.2.2-alpha.42 243 6/12/2020
1.2.2-alpha.40 258 6/12/2020
1.2.2-alpha.38 286 6/11/2020
1.2.2-alpha.35 258 6/3/2020
1.2.2-alpha.34 268 6/3/2020
1.2.2-alpha.32 351 5/31/2020
1.2.2-alpha.31 282 5/31/2020
1.2.2-alpha.30 283 5/30/2020
1.2.2-alpha.29 261 5/29/2020
1.2.2-alpha.28 269 5/8/2020
1.2.2-alpha.27 264 5/8/2020
1.2.2-alpha.26 248 4/27/2020
1.2.2-alpha.23 286 4/16/2020
1.2.2-alpha.21 287 4/16/2020
1.2.2-alpha.20 279 4/16/2020
1.2.2-alpha.19 241 4/14/2020
1.2.2-alpha.18 250 4/14/2020
1.2.2-alpha.17 249 4/14/2020
1.2.2-alpha.16 299 3/25/2020
1.2.2-alpha.15 295 3/15/2020
1.2.2-alpha.14 250 3/10/2020
1.2.2-alpha.13 246 3/10/2020
1.2.2-alpha.11 250 3/10/2020
1.2.2-alpha.10 253 3/10/2020
1.2.2-alpha.9 261 3/10/2020
1.2.2-alpha.8 283 3/9/2020
1.2.2-alpha.7 283 3/9/2020
1.2.2-alpha.6 297 3/9/2020
1.2.1-preview.3 270 11/8/2019
1.2.1-preview.1 284 11/5/2019
1.2.0-preview.3 296 10/18/2019
1.1.0 653 10/17/2019
1.1.0-preview.3 276 10/17/2019
1.0.8-preview.7 268 10/17/2019
1.0.8-preview.5 286 10/15/2019
1.0.8-preview.4 284 9/30/2019
1.0.8-preview.1 299 8/30/2019
1.0.7-preview.1 291 8/30/2019
1.0.6-preview.33 292 8/19/2019
1.0.6-preview.30 308 7/19/2019
1.0.6-preview.26 414 6/23/2019
1.0.6-preview.19 323 6/20/2019
1.0.6-preview.17 320 6/14/2019
1.0.6-preview.14 345 6/12/2019
1.0.6-preview.10 319 6/12/2019
1.0.6-preview.6 333 6/5/2019
1.0.6-preview.4 339 6/5/2019
1.0.6-preview.2 324 5/31/2019
1.0.5-preview-038 572 4/24/2019
1.0.5-preview-036 579 4/23/2019
1.0.5-preview-031 494 4/7/2019
1.0.5-preview-028 518 4/5/2019
1.0.5-preview-026 489 4/5/2019
1.0.5-preview-024 484 4/3/2019
1.0.5-preview-022 539 3/27/2019
1.0.5-preview-020 483 3/26/2019
1.0.5-preview-017 498 3/26/2019
1.0.5-preview-009 506 3/25/2019
1.0.5-preview-007 485 3/15/2019
1.0.5-preview-004 533 3/11/2019
1.0.5-preview-002 493 3/11/2019
1.0.5-preview-001 527 3/11/2019
1.0.4 1,034 1/22/2019
1.0.4-preview-009 519 3/10/2019
1.0.4-preview-003 645 1/3/2019
1.0.3 778 12/17/2018
1.0.2 766 11/15/2018
1.0.2-preview-009 643 11/20/2018
1.0.2-preview-005 623 11/8/2018