C# Web客戶端（開發者使用指南）

建立新的 WebClient

要開始使用 WebClient，您需要建立一個實例。 此範例可作為您提出 HTTP 請求的閘道。

以下是實體化 WebClient 的簡單方法：

// Create a new instance of WebClient
WebClient client = new WebClient();

// Create a new instance of WebClient
WebClient client = new WebClient();

此 new 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)";

設定使用者代理標頭非常重要，因為有些伺服器會檢查此標頭，以確定請求是否來自認可的瀏覽器或裝置。這會影響伺服器如何回應您的要求。

簡易檔案下載

WebClient 提供一種簡單的方法，可直接從 URL 下載檔案到本機檔案。這對需要操作外部資源的應用程式非常有用，例如下載組態檔案或更新。

// Example of downloading a file from a URL
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);
}

// Example of downloading a file from a URL
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);
}

在此示例中，DownloadFile 用於從 字串位址擷取檔案，並將其儲存為本機檔案。這個過程包裝在 try-catch 區塊中，以處理任何潛在的錯誤，例如內部伺服器錯誤或連線問題。

在記憶體中處理下載資料

有時候，您可能希望直接在記憶體中處理下載的資料，而不將其儲存至磁碟。 這可以使用 DownloadData 方法來完成，該方法會傳回一個位元組陣列：

// Example of downloading data into memory
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);
}

// Example of downloading data into memory
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);
}

在此，uriAddress 的資料會下載到一個位元組陣列中。 假設資料是 JSON 格式，就會轉換成字串。 在處理以 JSON 格式回傳資料的 API 時，在記憶體中處理資料尤其有用。

將資料發佈到伺服器

WebClient 也可用於將資料傳送至伺服器。 這通常使用 HTTP POST 方法來完成，您可以將資料作為請求體的一部分傳送。

// Example of posting data to a server
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);
}

// Example of posting data to a server
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);
}

此代碼片段將 postData 傳送至伺服器。 資料在傳送前會先編碼成一個位元組陣列。 WebClient 會自動處理 byte array 資料的內容類型標頭，但如果您需要傳送不同格式的資料，例如 JSON，您可能需要手動設定內容類型標頭。

程式碼範例

以下是使用 IronPDF 與 C# 的基本範例，利用 WebClient 類將 HTML 內容轉換為 PDF。 此範例程式碼示範如何從 URL 取得 HTML，然後再使用 IronPDF 從 HTML 產生 PDF 檔案。

using IronPdf;
using System.Net;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        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()
    {
        // Set your IronPDF license key
        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");
        }
    }
}

請務必在您的專案中加入 IronPDF 函式庫。 您通常可以在您的開發環境中透過 NuGet 執行這項工作，使用類似以下的指令：

Install-Package IronPdf

以下是生成的 PDF 檔案：