C# URL Encode（開発者向けの動作方法）

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名前空間がコードの先頭に包含されます。

元の文字列: URL で安全に送信するためにエンコードする文字を含む文字列変数originalStringを定義します。 これには、エンコードせずに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)に変換します。 URLには実際のスペースを含めることができないため、これは非常に重要です。

文字列値とURL文字列の処理: originalPath変数の文字列値は"/api/search/Hello World!"であり、これはスペースを含んでいるためにエンコードを必要とするURL文字列の典型的な例です。

この例では、メソッドのオーバーロードなしで HttpUtility.UrlPathEncode の特定のバージョンを使用していますが、URL パスをエンコードするためのメソッドの設計意図に注意することが重要です。 開発者は、メソッドのオーバーロードが存在する場合、メソッドを使用する別の方法を提供するため、多くの場合、異なるタイプの入力を受け入れるか、または追加の機能を提供するメソッドのオーバーロードに注意する必要があります。

エンコーディングオブジェクトと文字列URLの変換:このコンテキストにおけるエンコーディングオブジェクトは、文字列URLを受け取り、そのエンコードされたフォームを返すHttpUtility.UrlPathEncodeメソッドの操作に暗黙的に含まれています。 この方法では、特殊文字を適切な表現にエンコードしながらも、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がウェブブラウザやサーバによって正しく処理されるように、これらの特殊文字は"エスケープ"する必要があります。

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}");
    }
}