C# URL 編碼（開發者如何理解其工作原理）

HttpUtility.UrlEncode 方法的程式碼範例

using System;
using System.Web;

class Program
{
    static void Main()
    {
        string originalPath = "/api/search/Hello World!";
        string encodedPath = UrlEncode(originalPath);

        Console.WriteLine("Original Path: " + originalPath);
        Console.WriteLine("Encoded Path: " + encodedPath);
    }

    public static string UrlEncode(string originalString)
    {
        return HttpUtility.UrlEncode(originalString);
    }
}

using System;
using System.Web;

class Program
{
    static void Main()
    {
        string originalPath = "/api/search/Hello World!";
        string encodedPath = UrlEncode(originalPath);

        Console.WriteLine("Original Path: " + originalPath);
        Console.WriteLine("Encoded Path: " + encodedPath);
    }

    public static string UrlEncode(string originalString)
    {
        return HttpUtility.UrlEncode(originalString);
    }
}

命名空間包含： System.Web命名空間包含在程式碼的開頭。

原始字串：我們定義一個字串變數originalString，其中包含要編碼的字符，以便在 URL 中安全傳輸。 這包括空格和標點符號，如果未經編碼直接包含在 URL 中，可能會導致問題。

編碼：呼叫HttpUtility.UrlEncode方法，並將originalString作為參數。 該方法處理字串並傳回一個新字串，其中不安全字元被替換為它們的百分比編碼等效字元。 例如，空格會被替換為%20 。

輸出：最後，程式會將原始字串和編碼後的字串都印到控制台。

C# URL 編碼（開發者工作原理）：圖 1 - 控制台輸出顯示原始字串和編碼後的字串

HttpUtility.UrlPathEncode 方法的程式碼範例

using System;
using System.Web;

class Program
{
    static void Main()
    {
        // Define the original URL path, which includes spaces.
        string originalPath = "/api/search/Hello World!";

        // Use the HttpUtility.UrlPathEncode method to encode the path.
        string encodedPath = HttpUtility.UrlPathEncode(originalPath);

        // Output the original and encoded paths to the console.
        Console.WriteLine("Original Path: " + originalPath);
        Console.WriteLine("Encoded Path: " + encodedPath);
    }
}

using System;
using System.Web;

class Program
{
    static void Main()
    {
        // Define the original URL path, which includes spaces.
        string originalPath = "/api/search/Hello World!";

        // Use the HttpUtility.UrlPathEncode method to encode the path.
        string encodedPath = HttpUtility.UrlPathEncode(originalPath);

        // Output the original and encoded paths to the console.
        Console.WriteLine("Original Path: " + originalPath);
        Console.WriteLine("Encoded Path: " + encodedPath);
    }
}

URL 編碼中的字元實體等效項：所示程序轉換 URL 路徑的字串值，將空格轉換為其字元實體等效項 (%20) 以實現 Web 相容性。 這一點至關重要，因為網址不能包含實際的空格字元。

字串值和 URL 字串處理： originalPath變數的字串值為"/api/search/Hello World!"，這是一個典型的 URL 字串範例，由於包含空格，需要進行編碼。

雖然此範例使用了沒有方法重載的特定版本的HttpUtility.UrlPathEncode ，但需要注意的是該方法對 URL 路徑進行編碼的設計意圖。 開發人員應該了解方法重載的存在，因為它們提供了使用方法的替代方式，通常是透過接受不同類型的輸入或提供額外的功能來實現的。

編碼物件和字串 URL 轉換：在此上下文中，編碼物件隱含在 HttpUtility.UrlPathEncode 方法的操作中，該方法接受一個字串 URL 並傳回其編碼形式。 此方法確保 URL 路徑的結構保持不變，同時將特殊字元編碼成其適當的表示形式。

編碼路徑輸出：該程式演示了從原始路徑到編碼路徑的轉換。 這是一個對字串 URL 進行編碼以使其適應網路傳輸的直接範例，解決了空格和其他特殊字元可能引入的潛在問題。

C# URL 編碼（開發者工作原理）：圖 2 - 控制台輸出顯示原始字串和編碼後的字串

Uri.EscapeUriString 方法的程式碼範例

using System;

class Program
{
    static void Main()
    {
        string originalUri = "https://example.com/search?query=Hello World!";
        string escapedUri = Uri.EscapeUriString(originalUri);

        Console.WriteLine("Original URI: " + originalUri);
        Console.WriteLine("Escaped URI: " + escapedUri);
    }
}

using System;

class Program
{
    static void Main()
    {
        string originalUri = "https://example.com/search?query=Hello World!";
        string escapedUri = Uri.EscapeUriString(originalUri);

        Console.WriteLine("Original URI: " + originalUri);
        Console.WriteLine("Escaped URI: " + escapedUri);
    }
}

原始 URI： originalUri變數以表示完整 URI 的字串進行初始化，包括帶有空格和特殊字元的查詢字串。 為確保 URI 能被 Web 瀏覽器和伺服器正確處理，這些特殊字元需要進行"轉義"。

轉義 URI：呼叫Uri.EscapeUriString方法，並將originalUri作為其參數。 此方法掃描 URI 字串，並對不允許的字元或可能導致 URI 歧義的字元進行轉義。

輸出：程式會將原始 URI 和轉義後的 URI 同時列印到控制台。

C# URL 編碼（開發者工作原理）：圖 3 - 控制台輸出顯示原始字串和編碼後的字串

使用 URL 編碼的工作代碼範例

Install-Package IronPdf

using System.Web;
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your IronPDF license key
        string baseUrl = "https://example.com/search";

        // The query parameter with spaces that needs to be encoded
        string query = "Hello World!";

        // Encoding the query parameter to ensure the URL is correctly formatted
        string encodedQuery = HttpUtility.UrlEncode(query);

        // Constructing the full URL with the encoded query parameter
        string fullUrl = $"{baseUrl}?query={encodedQuery}";

        // Initialize the IronPDF HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Convert the web page at the encoded URL to a PDF document
        var pdf = renderer.RenderUrlAsPdf(fullUrl);

        // Save the PDF to a file
        string filePath = "webpage.pdf";
        pdf.SaveAs(filePath);

        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

using System.Web;
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your IronPDF license key
        string baseUrl = "https://example.com/search";

        // The query parameter with spaces that needs to be encoded
        string query = "Hello World!";

        // Encoding the query parameter to ensure the URL is correctly formatted
        string encodedQuery = HttpUtility.UrlEncode(query);

        // Constructing the full URL with the encoded query parameter
        string fullUrl = $"{baseUrl}?query={encodedQuery}";

        // Initialize the IronPDF HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Convert the web page at the encoded URL to a PDF document
        var pdf = renderer.RenderUrlAsPdf(fullUrl);

        // Save the PDF to a file
        string filePath = "webpage.pdf";
        pdf.SaveAs(filePath);

        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}