C# HttpClient使用方法與示例

C# HttpClient是C#中用於發送HTTP請求的API，在許多項目中都有大量的應用。本篇文章將從多個方面對C# HttpClient使用方法進行詳細闡述，並且會通過代碼示例來演示如何使用這個API。

一、HttpClient的基本使用

HttpClient的基本使用非常簡單，初始化HttpClient對象，設置請求參數，然後調用相應的方法即可。以下是一個基本的示例：

using System;
using System.Net.Http;

class Program
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了一個最簡單的GET請求的過程，首先初始化HttpClient對象，然後使用GetAsync方法發送請求，使用ReadAsStringAsync方法獲取返回的字元串並輸出。

二、發送POST請求

POST請求需要在請求頭中設置Content-Type頭部，並且在請求體中發送數據。下面演示如何使用C# HttpClient發送POST請求：

using System;
using System.Net.Http;

class Program
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        var content = new StringContent("{\"name\": \"example\"}", Encoding.UTF8, "application/json");
        using var response = await client.PostAsync("https://www.example.com", content);
        using var resultContent = response.Content;
        var result = await resultContent.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何使用C# HttpClient發送帶有請求體的POST請求。

三、添加請求頭

如果想要添加請求頭，可以使用Headers屬性來添加。具體代碼如下：

using System;
using System.Net.Http;

class Program
{
    static async Task Main(string[] args)
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36");
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何在HttpClient請求中添加請求頭。

四、使用代理

如果需要使用代理，可以在構造HttpClient對象時傳入HttpClientHandler對象，並設置Proxy屬性。以下是一個使用代理的示例：

using System;
using System.Net;
using System.Net.Http;

class Program
{
    static async Task Main(string[] args)
    {
        var handler = new HttpClientHandler
        {
            Proxy = new WebProxy("http://127.0.0.1:8888")
        };
        using var client = new HttpClient(handler);
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何在C# HttpClient中使用代理。

五、使用Cookie

如果需要在請求中使用Cookie，可以在HttpClientHandler對象中設置CookieContainer屬性。以下是一個使用Cookie的示例：

using System;
using System.Net.Http;

class Program
{
    static async Task Main(string[] args)
    {
        var handler = new HttpClientHandler
        {
            CookieContainer = new CookieContainer()
        };
        using var client = new HttpClient(handler);
        var cookies = new CookieCollection
        {
            new Cookie("example_cookie", "example_value")
        };
        handler.CookieContainer.Add(new Uri("https://www.example.com"), cookies);
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何在C# HttpClient中使用Cookie。

六、使用證書

如果需要使用HTTPS請求並且需要驗證證書，可以在HttpClientHandler對象中設置ClientCertificateOptions屬性。以下是一個使用證書的示例：

using System;
using System.Net.Http;
using System.Security.Authentication;
using System.Security.Cryptography.X509Certificates;

class Program
{
    static async Task Main(string[] args)
    {
        var handler = new HttpClientHandler
        {
            SslProtocols = SslProtocols.Tls12,
            ClientCertificateOptions = ClientCertificateOption.Manual,
            ServerCertificateCustomValidationCallback = (sender, certificate, chain, errors) => true
        };
        handler.ClientCertificates.Add(new X509Certificate2("example.pfx", "password"));
        using var client = new HttpClient(handler);
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何在C# HttpClient中使用證書。

七、使用代理和證書

以上幾個示例可以通過組合進行高級需求，以下演示如何在C# HttpClient中同時使用代理和證書：

using System;
using System.Net;
using System.Net.Http;
using System.Security.Authentication;
using System.Security.Cryptography.X509Certificates;

class Program
{
    static async Task Main(string[] args)
    {
        var handler = new HttpClientHandler
        {
            Proxy = new WebProxy("http://127.0.0.1:8888"),
            SslProtocols = SslProtocols.Tls12,
            ClientCertificateOptions = ClientCertificateOption.Manual,
            ServerCertificateCustomValidationCallback = (sender, certificate, chain, errors) => true
        };
        handler.ClientCertificates.Add(new X509Certificate2("example.pfx", "password"));
        using var client = new HttpClient(handler);
        using var response = await client.GetAsync("https://www.example.com");
        using var content = response.Content;
        var result = await content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

上面的代碼演示了如何在C# HttpClient中同時使用代理和證書。