C# URL Encode (개발자들에게 어떻게 작동하는가)

C#의 URL 인코딩

URL을 인코딩하면 문자를 인터넷을 통해 안전하게 보낼 수 있는 형태로 변경하여 오해를 피합니다. 이는 URL이 ASCII 문자 세트를 사용하여 인터넷을 통해 전송될 수 있기 때문입니다. 이 세트의 일부가 아닌 문자 또는 URL에서 특수한 의미를 가지는 문자(예: 공백, 앰퍼샌드 및 등호)는 퍼센트 인코딩을 사용하여 표현해야 합니다(예: 공백은 %20으로 변환됨). C#은 이 작업을 수행할 수 있는 내장 메서드를 제공합니다.

C#의 URL 디코딩

URL 디코딩은 목적지에 도착했을 때 인코딩된 문자를 원래 상태로 변환합니다. 이는 수신 응용 프로그램이 데이터를 올바르게 이해하고 처리하기 위해 필수적입니다. 디코딩은 퍼센트 인코딩된 문자를 원래의 기호로 다시 변환하여 데이터를 다시 읽고 사용할 수 있게 만듭니다.

C#에서의 인코딩 방법

C#에서는 다른 시나리오에 적합한 다양한 URL 인코딩 방법이 있습니다. 이러한 방법은 주로 System.Web 및 System.Net 네임스페이스 내에서 발견되며, 개발자가 URL을 인코딩하는데 유연성을 제공합니다. 사용 가능한 방법의 간략한 개요는 다음과 같습니다:

1. HttpUtility.UrlEncode 메서드 (System.Web): 웹 응용 프로그램에서 URL 인코딩을 위해 가장 일반적으로 사용되는 방법 중 하나입니다. 문자를 퍼센트 인코딩 형식으로 변환하여 문자열을 URL을 통해 전송할 수 있도록 안전하게 만들어줍니다. 특히 ASP.NET 프로젝트에서 쿼리 문자열 및 폼 매개변수를 인코딩하는 데 유용합니다.
2. HttpUtility.UrlPathEncode 메서드 (System.Web): UrlEncode와 달리, UrlPathEncode는 URL의 경로 부분을 인코딩하기 위해 특별히 설계되었으며 쿼리 문자열은 그대로 둡니다. 이 메서드는 전체 URL을 인코딩하지 않고 경로 부분만 인코딩하여 URL의 계층적 구조가 보존되도록 보장합니다.
3. Uri.EscapeUriString 메서드 (System): 이 메서드는 URI 문자열을 회피하도록 의도되었으며, URI에 허용되지 않는 모든 문자를 퍼센트 인코딩된 형태로 변환합니다. 그러나 URI에서 유효한 문자로 간주되는 슬래시(/) 및 물음표 (?)와 같은 특정 문자는 인코딩하지 않습니다.
4. Uri.EscapeDataString 메서드 (System): 이 메서드는 URI의 쿼리 부분에 사용될 문자열을 인코딩하기 위해 설계되었습니다. RFC 3986에서 정의한 예약되지 않은 문자를 제외한 모든 문자를 인코딩하며, EscapeUriString보다 더 공격적으로 데이터를 URL 내에서 안전하게 인코딩할 수 있도록 보장합니다.

위에 설명된 첫 번째 세 가지 인코딩 방법을 이해하고, 코드 예제를 통해 그들이 어떻게 작동하는지 이해해 봅시다.

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

Imports System
Imports System.Web

Friend Class Program
	Shared Sub Main()
		Dim originalPath As String = "/api/search/Hello World!"
		Dim encodedPath As String = UrlEncode(originalPath)

		Console.WriteLine("Original Path: " & originalPath)
		Console.WriteLine("Encoded Path: " & encodedPath)
	End Sub

	Public Shared Function UrlEncode(ByVal originalString As String) As String
		Return HttpUtility.UrlEncode(originalString)
	End Function
End Class

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

Imports System
Imports System.Web

Friend Class Program
	Shared Sub Main()
		' Define the original URL path, which includes spaces.
		Dim originalPath As String = "/api/search/Hello World!"

		' Use the HttpUtility.UrlPathEncode method to encode the path.
		Dim encodedPath As String = HttpUtility.UrlPathEncode(originalPath)

		' Output the original and encoded paths to the console.
		Console.WriteLine("Original Path: " & originalPath)
		Console.WriteLine("Encoded Path: " & encodedPath)
	End Sub
End Class

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

Imports System

Friend Class Program
	Shared Sub Main()
		Dim originalUri As String = "https://example.com/search?query=Hello World!"
		Dim escapedUri As String = Uri.EscapeUriString(originalUri)

		Console.WriteLine("Original URI: " & originalUri)
		Console.WriteLine("Escaped URI: " & escapedUri)
	End Sub
End Class

IronPDF: C# PDF 라이브러리

IronPDF는 .NET 애플리케이션 내에서 PDF 파일을 생성, 편집 및 조작하는 작업을 간소화하는 PDF 라이브러리입니다. C# 및 VB.NET과 원활하게 통합되도록 설계된 IronPDF는 개발자에게 HTML이나 텍스트에서 PDF를 생성하는 기능을 제공합니다. 인보이스 생성을 자동화하거나, 동적 보고서를 생성하거나, .NET 환경에서 문서를 관리할 때, IronPDF는 사용의 용이함과 포괄적인 기능 세트로 두드러집니다.

IronPDF의 하이라이트는 레이아웃 및 스타일을 유지하는 HTML to PDF 변환 기능입니다. 이는 보고서, 인보이스 및 문서에 적합한 웹 콘텐츠에서 PDF 생성이 가능합니다. HTML 파일, URL 및 HTML 문자열은 손쉽게 PDF로 변환될 수 있습니다.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

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

Imports System.Web
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		License.LicenseKey = "License-Key" ' Set your IronPDF license key
		Dim baseUrl As String = "https://example.com/search"

		' The query parameter with spaces that needs to be encoded
		Dim query As String = "Hello World!"

		' Encoding the query parameter to ensure the URL is correctly formatted
		Dim encodedQuery As String = HttpUtility.UrlEncode(query)

		' Constructing the full URL with the encoded query parameter
		Dim fullUrl As String = $"{baseUrl}?query={encodedQuery}"

		' Initialize the IronPDF HtmlToPdf renderer
		Dim renderer = New ChromePdfRenderer()

		' Convert the web page at the encoded URL to a PDF document
		Dim pdf = renderer.RenderUrlAsPdf(fullUrl)

		' Save the PDF to a file
		Dim filePath As String = "webpage.pdf"
		pdf.SaveAs(filePath)

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

결론

마무리하자면, C#은 인터넷을 통해 데이터를 안전하고 효율적으로 전송할 수 있도록 URL 인코딩 및 디코딩을 위한 강력한 기능을 제공합니다. System.Web 및 System.Net 네임스페이스 내의 내장 메소드를 통해, 개발자는 특수 문자의 문제를 방지하기 위해 URL을 인코딩하고 정확한 데이터 해석을 위해 원래 형태로 디코딩할 수 있습니다.

IronPDF 체험판 라이선스 제공을 탐색에 관심이 있는 이들에게는 기능을 직접 평가할 기회를 제공합니다. IronPDF를 프로젝트에 통합하기로 결정하신다면, 라이선스는 $799에서 시작하며 .NET Framework 내에서 PDF 조작 요구를 충족하기 위한 종합적인 기능을 제공합니다.