HTTP

Frends.HTTP.DownloadFile / 2.0.0

Summary

Fetches a URL and streams the response straight into a file, so the payload never has to sit in the Process's memory.

Typical use — large downloads, where the general request Task would hold the whole body in memory

Details

Frends version
5.7 and newer
Agent
Crossplatform
Target framework
net8.0
2.0.02026-10-26
Added
  • Added ThrowErrorOnFailure and ErrorMessageOnFailure options. By default errors are still thrown as before; when ThrowErrorOnFailure is false the Task returns Success = false and an Error object instead.
  • Added Error property to the Task result.
  • Breaking Task rethrows exception when occured instead of creating a new generic Exception.
Changed
  • Task now targets .NET 8.
1.6.02026-10-20
Changed
  • HTTP client cache key is now derived with PBKDF2-SHA256.
1.5.02026-05-13
Added
  • Added UseProxy, ProxyUrl, ProxyUsername, ProxyPassword, HttpProtocolVersion, and SslProtocolVersion options with proxy handler and protocol configuration support.
1.4.02026-03-02
Added
  • Added CertificateStoreLocation option to allow selection between CurrentUser and LocalMachine certificate stores when using certificate authentication.
1.3.02025-05-15
Changed
  • Added new Overwrite parameter to control whether the downloaded file should replace an existing one.
  • Use the default parameter value ('false') if you want the task to work as before.
1.2.02025-03-25
Changed
  • Update packages: System.Runtime.Caching 7.0.0 -> 9.0.3 coverlet.collector 3.1.0 -> 6.0.4 Microsoft.NET.Test.Sdk 16.7.0 -> 17.13.0 MSTest.TestAdapter 2.1.2 -> 3.8.3 MSTest.TestFramework 2.1.2 -> 3.8.3
1.1.02024-12-30
Changed
  • Descriptions of ClientCertificate suboptions includes clearer information about usage in terms of different types of ClientCertificate.
1.0.02023-01-27
Added
  • Initial implementation.
An unhandled error has occurred. Reload 🗙