1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. WebClient C#
.NET 帮助

WebClient C#（开发者如何使用）

发布 2024年六月6日
分享:

网络客户端 是一个功能强大的 C# 类，用于通过网络发送和接收数据。它是 .NET Framework 的System.Net命名空间的一部分，适用于各种应用，从简单的文件下载到向网络服务器发送数据。

本教程介绍如何有效地使用 WebClient 类，重点是其核心功能以及如何处理下载文件和发布数据等常见情况。我们还将探讨 IronPDF 库 与 WebClient 一起使用。

WebClient 的基本使用

创建新的 WebClient

要开始使用 Web Client，您需要创建一个实例。该实例将作为您发出 HTTP 请求的网关。

下面是一个实例化 WebClient 的简单方法：

WebClient client = new WebClient();
WebClient client = new WebClient();
Dim client As New WebClient()
VB   C#

这个新的 WebClient() 是一项基本设置。它为应用程序与 HTTP 服务器交互做好准备。创建该实例后，您就可以使用 WebClient 类提供的各种方法来下载和上传数据。

设置 WebClient 属性

在开始发出请求之前，你可能想自定义 WebClient 实例的行为。例如，您可以设置一个用户代理标头，告诉服务器发出请求的客户端：

// Adding user-agent to the HTTP headers
client.Headers["User-Agent"] = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)";
// Adding user-agent to the HTTP headers
client.Headers["User-Agent"] = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)";
' Adding user-agent to the HTTP headers
client.Headers("User-Agent") = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
VB   C#

设置用户代理标头很重要，因为有些服务器会检查该标头，以确定请求是否来自一个公认的浏览器或设备。这会影响服务器对请求的响应。

使用 WebClient 下载数据

简单文件下载

WebClient 提供了一种直接从 URL 下载文件到本地文件的简单方法。这对于需要使用外部资源（如下载配置文件或更新）的应用程序非常有用。

// Download file from the specified URI address
string address = "http://example.com/file.zip";
string localFile = "C:\\Downloads\\file.zip";
try
{
    client.DownloadFile(address, localFile);
    Console.WriteLine("Download complete.");
}
catch (Exception ex)
{
    Console.WriteLine("Download failed: " + ex.Message);
}
// Download file from the specified URI address
string address = "http://example.com/file.zip";
string localFile = "C:\\Downloads\\file.zip";
try
{
    client.DownloadFile(address, localFile);
    Console.WriteLine("Download complete.");
}
catch (Exception ex)
{
    Console.WriteLine("Download failed: " + ex.Message);
}
' Download file from the specified URI address
Dim address As String = "http://example.com/file.zip"
Dim localFile As String = "C:\Downloads\file.zip"
Try
	client.DownloadFile(address, localFile)
	Console.WriteLine("Download complete.")
Catch ex As Exception
	Console.WriteLine("Download failed: " & ex.Message)
End Try
VB   C#

在本例中，"DownloadFile "用于从字符串地址获取文件，并将其保存为本地文件。该过程被包裹在一个 try-catch 块中，以处理任何潜在的错误，如内部服务器错误或连接问题。

处理内存中的下载数据

有时，您可能希望直接在内存中处理下载数据，而不将其保存到磁盘。这可以使用返回字节数组的 DownloadData 方法来实现：

string uriAddress = "http://example.com/data.json";
try
{
    byte[] data = client.DownloadData(uriAddress);
    string json = System.Text.Encoding.UTF8.GetString(data);
    Console.WriteLine("Data received: " + json);
}
catch (Exception ex)
{
    Console.WriteLine("Error receiving data: " + ex.Message);
}
string uriAddress = "http://example.com/data.json";
try
{
    byte[] data = client.DownloadData(uriAddress);
    string json = System.Text.Encoding.UTF8.GetString(data);
    Console.WriteLine("Data received: " + json);
}
catch (Exception ex)
{
    Console.WriteLine("Error receiving data: " + ex.Message);
}
Dim uriAddress As String = "http://example.com/data.json"
Try
	Dim data() As Byte = client.DownloadData(uriAddress)
	Dim json As String = System.Text.Encoding.UTF8.GetString(data)
	Console.WriteLine("Data received: " & json)
Catch ex As Exception
	Console.WriteLine("Error receiving data: " & ex.Message)
End Try
VB   C#

在这里，uriAddress中的数据被下载到一个字节数组中。然后，假设数据是 JSON 格式，则将其转换为字符串。在处理以 JSON 格式返回数据的 API 时，在内存中处理数据尤其有用。

使用 WebClient 上传数据

将数据发布到服务器

WebClient 也可用于向服务器发送数据。这通常使用 HTTP POST 方法，即把数据作为请求体的一部分发送。

string postAddress = "http://example.com/api/post";
// Prepare string data for POST request
string stringData = "name=John&age=30";
byte[] postData = System.Text.Encoding.ASCII.GetBytes(stringData);
try
{
    byte[] response = client.UploadData(postAddress, "POST", postData);
    // Log response headers and content
    Console.WriteLine("Response received: " + System.Text.Encoding.ASCII.GetString(response));
}
catch (Exception ex)
{
    Console.WriteLine("Post failed: " + ex.Message);
}
string postAddress = "http://example.com/api/post";
// Prepare string data for POST request
string stringData = "name=John&age=30";
byte[] postData = System.Text.Encoding.ASCII.GetBytes(stringData);
try
{
    byte[] response = client.UploadData(postAddress, "POST", postData);
    // Log response headers and content
    Console.WriteLine("Response received: " + System.Text.Encoding.ASCII.GetString(response));
}
catch (Exception ex)
{
    Console.WriteLine("Post failed: " + ex.Message);
}
Dim postAddress As String = "http://example.com/api/post"
' Prepare string data for POST request
Dim stringData As String = "name=John&age=30"
Dim postData() As Byte = System.Text.Encoding.ASCII.GetBytes(stringData)
Try
	Dim response() As Byte = client.UploadData(postAddress, "POST", postData)
	' Log response headers and content
	Console.WriteLine("Response received: " & System.Text.Encoding.ASCII.GetString(response))
Catch ex As Exception
	Console.WriteLine("Post failed: " & ex.Message)
End Try
VB   C#

此代码段向服务器发送 postData。数据在发送前首先编码成字节数组。WebClient 会自动处理字节数组数据的内容类型标头，但如果您需要发送不同格式的数据（如 JSON），则可能需要手动设置内容类型标头。

带有 WebClient 的 IronPDF

IronPDF 是一个 .NET 库，可帮助开发人员轻松创建、编辑和管理 PDF 文件。它使用 Chrome 浏览器渲染引擎实现精确的 HTML 转换为 PDF.该库可将网页内容、HTML 和图像转换为 PDF，并包含数字签名和表单处理等功能。

它可与各种.NET版本兼容，支持多种操作系统，因此适用于不同的开发环境。IronPDF 提供全面的文档和强大的支持，帮助开发人员顺利集成 PDF 功能。

代码示例

下面是一个使用 IronPDF 和 C# 的基本示例，使用 WebClient 类将 HTML 内容转换为 PDF。该示例代码演示了如何从 URL 获取 HTML，然后使用 IronPDF 从 HTML 生成 PDF 文件。

using IronPdf;
using System.Net;
class Program
{
    static void Main()
    {
        License.LicenseKey = "License-Key";
        // Create a new WebClient instance to download HTML
        using (WebClient client = new WebClient())
        {
            // Specify the URL of the HTML page
            string url = "http://example.com";
            string htmlString = client.DownloadString(url);
            // Create a new HTML to PDF converter instance
            var renderer = new ChromePdfRenderer();
            // Convert HTML string to PDF
            var pdf = renderer.RenderHtmlAsPdf(htmlString);
            // Save the PDF to a file
            pdf.SaveAs("output.pdf");
        }
    }
}
using IronPdf;
using System.Net;
class Program
{
    static void Main()
    {
        License.LicenseKey = "License-Key";
        // Create a new WebClient instance to download HTML
        using (WebClient client = new WebClient())
        {
            // Specify the URL of the HTML page
            string url = "http://example.com";
            string htmlString = client.DownloadString(url);
            // Create a new HTML to PDF converter instance
            var renderer = new ChromePdfRenderer();
            // Convert HTML string to PDF
            var pdf = renderer.RenderHtmlAsPdf(htmlString);
            // Save the PDF to a file
            pdf.SaveAs("output.pdf");
        }
    }
}
Imports IronPdf
Imports System.Net
Friend Class Program
	Shared Sub Main()
		License.LicenseKey = "License-Key"
		' Create a new WebClient instance to download HTML
		Using client As New WebClient()
			' Specify the URL of the HTML page
			Dim url As String = "http://example.com"
			Dim htmlString As String = client.DownloadString(url)
			' Create a new HTML to PDF converter instance
			Dim renderer = New ChromePdfRenderer()
			' Convert HTML string to PDF
			Dim pdf = renderer.RenderHtmlAsPdf(htmlString)
			' Save the PDF to a file
			pdf.SaveAs("output.pdf")
		End Using
	End Sub
End Class
VB   C#

确保将 IronPDF 库添加到项目中。通常可以通过开发环境中的 NuGet 来完成，使用的命令如下

Install-Package IronPdf

下面是生成的 PDF 文件：

WebClient C#（如何为开发人员工作）：图 1

结论

WebClient 是 .NET Framework 中的一个多用途类，适用于各种网络操作，包括下载和上传文件。本教程介绍了如何启动 WebClient、自定义标题、管理数据下载和上传以及有效处理错误。

随着对 WebClient 的进一步熟悉，您可以探索更多高级功能，并考虑采用 HttpClient 等更强大的解决方案来处理更复杂的情况。IronPDF 允许开发人员使用以下工具探索其功能 免费试用，可从 $749 获取许可证。

< 前一页
Polly Retry（开发人员如何使用）
下一步 >
C# 捕获多个异常（开发人员如何使用）

报告问题

准备开始了吗？ 版本： 2024.10 刚刚发布

免费NuGet下载 总下载量: 11,108,738 查看许可证 >

获取您的免费

30天试用密钥 立即。

15天试用密钥 立即。

bullet_checked无需信用卡或创建账户
试用表格已提交
成功地。

您的试用密钥应在电子邮件中。
如果不是，请联系
support@ironsoftware.com

子弹测试测试生产环境
无水印
子弹日历30天全功能使用
功能性产品
子弹支持24/5技术支持
试用期间的支持

谢谢！

您的许可证密钥已发送到所提供的电子邮件。联系我们

24小时升级优惠：

Save 50% 在一个
专业 升级

去 专业 支持10位开发者
和无限项目。

小时

:

分钟

:

秒

升级到Professional

升级

专业

$600 美元

$299 美元

  • 10位开发者
  • 10个位置
  • 10个项目
今天 只有

5个.NET产品，两件的价格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

套件总价值：

$7,192 美元

升级价格

今天
只有

$499 美元

24小时后

$1,098 美元