Save File from URL Using C#

To save a file from URL in C#, create an empty HTMLDocument, build a RequestMessage for the target URL, send it with document.Context.Network.Send(request), check the response status, and write the response bytes to a local file.

This article shows a C# example that you can use to save a file from URL. When you download a file from a URL, you can access, share, save, and use the file from the web for different purposes depending on your needs.

There are a few reasons why you may want to save files:

• When you save files from URLs, you can access and use those files offline when internet access is limited or unavailable.
• Saving files can help with sharing and collaboration, content distribution, or file exchange purposes.
• You may want to save files for later usage or reference. This can be documents, texts, images, videos, audio, or other types of files that you want to keep for future use.
• Saving files for archiving and backup is useful for preserving important files and protecting them from possible loss or other unforeseen events.
• You can download a file from a URL for learning purposes, get learning materials, and learn from anywhere, such as during commuting, travel, or in remote locations.
• You can automate resource collection when a document processing workflow depends on external files.

Save a File from URL in C#

To save a file from URL, you need to know its URL and have a network operations handler suitable for its protocol. Aspose.HTML for .NET provides a network layer for retrieving resources over HTTP and HTTPS. To use it, create an empty HTML document and call the network request handler, as shown in the following C# example.

To save a file from URL in C#:

1. Use the HTMLDocument() constructor to create a blank document.
2. Create a URL with the path to the resource you want to save.
3. Use the RequestMessage(url) constructor to create a new RequestMessage instance that represents an HTTP request message.
4. Use the Context.Network.Send(request) method to send the request.
5. Check whether the response is successful before reading the content.
6. If the response is successful, use File.WriteAllBytes() to save the downloaded file to the local file system.

Let’s look at how to save a file from URL using the Aspose.HTML C# library:

// Download file from URL using C#

// Create a blank document; it is required to access the network operations functionality
using HTMLDocument document = new HTMLDocument();

// Create a URL with the path to the resource you want to download
Url url = new Url("https://docs.aspose.com/html/images/handlers/message-handlers.png");

// Create a file request message
using RequestMessage request = new RequestMessage(url);

// Download file from URL
using ResponseMessage response = document.Context.Network.Send(request);

// Check whether response is successful
if (response.IsSuccess)
{
    // Save file to a local file system
    File.WriteAllBytes(Path.Combine(OutputDir, url.Pathname.Split('/').Last()), response.Content.ReadAsByteArray());
}

Common Mistakes and Fixes

Problem	Cause	Solution
Downloaded file is empty	The response body is read without checking the response status.	Always check whether the response is successful before reading content.
404 error with a valid-looking URL	The URL contains unencoded spaces, special characters, or an incorrectly resolved relative path.	Encode URL parts when needed and use the page base URL when resolving relative links.
OutOfMemoryException with large files	The entire response is loaded into memory with a byte array.	Stream the response and copy it in chunks using a buffer.
Saved file has the wrong extension	The URL path or redirect does not match the actual content type.	Check response headers and choose the local file name or extension intentionally.
Request fails in a server or container environment	Network access, proxy settings, certificates, or allowed URLs are restricted.	Verify network permissions, proxy configuration, and CA certificates in the runtime environment.

FAQ

Can I download files using HTTP POST?

Yes. Set request.Method = HttpMethod.Post and add content with request.Content = new StringContent(...) before sending the request.

How do I add custom headers such as API keys?

Use request.Headers.Add("Header-Name", "value") before sending the request.

Does Aspose.HTML support FTP downloads?

The built-in network layer is intended for HTTP and HTTPS workflows. FTP requires a custom network implementation outside the standard example shown on this page.

Can I use this approach for large files?

For large files, avoid loading the entire response into memory. Stream the response content and copy it to a file in chunks.

How do I download a PDF from a URL in C#?

Use the same RequestMessage and Network.Send() workflow shown in the main example. Pass the PDF URL, check response.IsSuccess, read the response bytes, and save them with a .pdf extension using File.WriteAllBytes().

Aspose.HTML transfers the PDF as binary content but does not parse or edit the PDF document. If you only need to download a known PDF URL and the task is not part of an Aspose.HTML workflow, the standard .NET HttpClient is sufficient. Before saving content from an untrusted URL or a URL that redirects, verify the response status and, when available, the Content-Type header.

Other Platforms

• Save File from URL in Java – download files from URLs with Aspose.HTML for Java.
• Save File from URL in Python via .NET – download files from URLs with Aspose.HTML for Python via .NET.

Related Data Extraction Articles

• HTML Navigation in C# – inspect HTML and find resource URLs with DOM, XPath, or CSS selectors.
• Extract SVG From Website – extract inline and external SVG from web pages.
• Extract Images From Website – collect and save image files from websites.
• Website to HTML in C# – save a web page and related resources.
• Edit HTML Document – modify HTML content programmatically.

You can download files from URLs using complete C# examples from the Aspose.HTML for .NET GitHub repository.