C#网络编程System.Net.WebClient 类vs System.Net.Http.HttpClient 类

本文介绍: 为什么要把两者拿出来p k呢？那是因为We bCli ent已经在.NET 6.0以后得版本被弃用了，一旦在.NET 6.0以上的框架下使用时，会产生SYSLIB0014 警告。虽然可以根据提示采取措施禁止警告，但已经是不正常的状态了。SYSLIB0014 警告 – .NET | Mic ro soft Le arn从 .NET 6 开始，将以下 API 标记为已过时。在代码中使用这些 API 会在编译时生成警告 SYSLIB0014。并提示解决方法：请改用 Ht t pCli ent。

一、WebClient 类

1.WebClient 将数据上传到资源的方法

2.WebClient 从资源下载数据的方法

为什么要把两者拿出来pk呢？那是因为We bCli ent已经在.NET 6.0以后得版本被弃用了，一旦在.NET 6.0以上的框架下使用时，会产生SYSLIB0014 警告。虽然可以根据提示采取措施禁止警告，但已经是不正常的状态了。

SYSLIB0014 警告 – .NET | Mic ro soft Learn https://learn.microsoft.com/zh-cn/dotnet/fundamentals/syslib-diagnostics/syslib0014

从 .NET 6 开始，将以下 API 标记为已过时。在代码中使用这些 API 会在编译时生成警告 SYSLIB0014。并提示解决方法：请改用 Ht tpClient。

        WebReque st()
        Sy ste m.Net.WebReque st.Cre ate
        Sy ste m.Net.WebReque st.Cre ateHttp
        Sy stem.Net.WebReque st.CreateDefa ult(Ur i)
        HttpWebReque st(Ser i alizationInf o, Streamin gCon text)
        Sy stem.Net.Ser vi cePo intMana ger.Fi ndSer v icePo int
        WebClient()

一、WebClient 类

命名空间:Sy stem.Net。提供用于将数据发送到由 URI 标识的资源及从这样的资源接收数据的常用方法。

类 WebClient 提供用于将数据发送到或从 URI 标识的任何本地、Intranet 或 Internet 资源接收数据的常用方法。

类 WebClient 使用 WebReque st 类提供对资源的访问权限。 WebClient实例可以访问使用方法注册WebRequest.RegisterPre fix的任何WebRequest后代的数据。

1.WebClient 将数据 上传到资源的方法

方法	说明
OpenWrite	Stream检索用于将数据发送到资源的。
OpenWriteAsync	Stream检索用于将数据发送到资源的，而不会阻止调用线程。
UploadData	将字节数组发送到资源，并返回包含任何响应的 Byte 数组。
UploadDataAsync	在不 Byte 阻止调用线程的情况下，将数组发送到资源。
UploadFile	将本地文件发送到资源并返回包含任何响应的 Byte 数组。
UploadFileAsync	在不阻止调用线程的情况下，将本地文件发送到资源。
UploadValues	将发送到 NameValueCollection 资源并返回包含任何响应的 Byte 数组。
Uplo adValuesAsync	将发送到 NameValueCollection 资源并返回包含 Byte 任何响应的数组，而不会阻止调用线程。
Uplo adStrin g	将发送到 Strin g 资源，并返回包含 String 任何响应的。
UploadStringAsync	将发送到 String 资源，而不会阻止调用线程。

2.WebClient 从资源下载 数据的方法

方法	说明
OpenRead	以的形式 Stream返回资源中的数据。
OpenReadAsync	从资源返回数据，而不会阻止调用线程。
Down loadData	从资源下载数据并返回 Byte 数组。
Down loadDataAsyn c	从资源下载数据并返回 Byte 数组，而不会阻止调用线程。
Downloa dFile	将数据从资源下载到本地文件。
Downloa dFileAsyn c	将数据从资源下载到本地文件，而不会阻止调用线程。
DownloadString	String从资源下载并返回 String。
DownloadStringAsyn c	从资源下载， String 而不会阻止调用线程。

3.示例 源码

// WebClient
// .NET 4.8控制台应用
// The following code example creates a WebClient instance 
// and then uses it to download data from a server and display it on the system console, 
// to download data from a server and write it to a file, 
// and to upload form values to a server and receive the response. 
using System;
using System.Collections.Specialized;
using System.Net;
using System.Text;

namespace ConsoleApp2
{
    internal class Program
    {
        static void Main(string[] args)
        {
            try
            {
                // Download the data to a buffer.
                WebClient client = new WebClient();

                byte[] pageData = client.DownloadData("http://www.contoso.com");
                string pageHtml = Encoding.ASCII.GetString(pageData);
                Console.WriteLine(pageHtml);

                // Download the data to a file.
                client.DownloadFile("http://www.contoso.com", "page.htm");

                // Upload some form post values.
                NameValueCollection form = new NameValueCollection
                {
                    { "MyName", "MyValue" }
                };
                byte[] responseData = client.UploadValues("http://www.contoso.com/form.aspx", form);
            }
            catch (WebException webEx)
            {
                Console.WriteLine(webEx.ToString());
                if (webEx.Status == WebExceptionStatus.ConnectFailure)
                {
                    Console.WriteLine("Are you behind a firewall?  If so, go through the proxy server.");
                }
            }
        }
    }
}

4.生成 效果

<html>
    <head>
        <title>Microsoft Corporation</title>
        <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7"></meta>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><meta name="SearchTitle" content="Microsoft.com" scheme=""></meta>
        <meta name="Description" content="Get product information, support, and news from Microsoft." scheme=""></meta>
        <meta name="Title" content="Microsoft.com Home Page" scheme=""></meta>
        <meta name="Keywords" content="Microsoft, product, support, help, training, Office, Windows, software, download, trial, preview, demo,  business, security, update, free, computer, PC, server, search, download, install, news" scheme=""></meta>
        <meta name="SearchDescription" content="Microsoft.com Homepage" scheme=""></meta>
    </head>
    <body>
        <p>Your current User-Agent string appears to be from an automated process, if this is incorrect, please click this link:<a href="http://www.microsoft.com/en/us/default.aspx?redir=true">United States English Microsoft Homepage</a></p>
    </body>
</html>

二、HttpClient 类

命名空间:System.Net.Http。一个用于从 URI 标识的资源发送 HTTP 请求和接收 HTTP 响应的类。

1.示例 源码

// HttpClient
// HttpClient is intended to be instantiated once per application, rather than per-use. See Remarks.
// Call asynchronous network methods in a try/catch block to handle exceptions.
namespace test1 
{  
    class Program
    {
        static readonly HttpClient client = new();
        static async Task Main()
        {           
            try
            {
                using HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                // Above three lines can be replaced with new helper method below
                // string responseBody = await client.GetStringAsync(uri);

                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine("nException Caught!");
                Console.WriteLine("Message :{0} ", e.Message);
            }
        }
    }  
}

2.生成效果

// 运行结果 
<html>
    <head>
        <title>Microsoft Corporation</title>
        <meta http-equiv="X-UA-Compatible" content="IE=EmulateIE7"></meta>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
        <meta name="SearchTitle" content="Microsoft.com" scheme=""></meta>
        <meta name="Description" content="Get product information, support, and news from Microsoft." scheme=""></meta>
        <meta name="Title" content="Microsoft.com Home Page" scheme=""></meta>
        <meta name="Keywords" content="Microsoft, product, support, help, training, Office, Windows, software, download, trial, preview, demo,  business, security, update, free, computer, PC, server, search, download, install, news" scheme=""></meta>
        <meta name="SearchDescription" content="Microsoft.com Homepage" scheme=""></meta>
    </head>
    <body>
        <p>Your current User-Agent string appears to be from an automated process, if this is incorrect, please click this link:<ahref="http://www.microsoft.com/en/us/default.aspx?redir=true">United States English Microsoft Homepage</a></p>
    </body>
</html>