Codificação de URL em C# (Como funciona para desenvolvedores)

Codificação de URL em C

Ao codificar um URL, você transforma seus caracteres em um formato que pode ser enviado com segurança pela internet, evitando mal-entendidos. Isso ocorre porque os URLs só podem ser enviados pela Internet usando o conjunto de caracteres ASCII. Caracteres que não fazem parte deste conjunto, ou que têm significados especiais em URLs (como espaços, e comerciais e sinais de igual), precisam ser representados usando codificação percentual (por exemplo, espaços se tornam %20 ). O C# fornece métodos integrados para realizar essa tarefa.

Decodificação de URL em C

A decodificação de URL transforma os caracteres codificados de volta ao seu estado original ao chegarem ao destino. Isso é essencial para que o aplicativo receptor entenda e processe os dados corretamente, conforme o esperado. A decodificação transforma os caracteres codificados em porcentagem de volta em seus símbolos originais, tornando os dados legíveis e utilizáveis ​​novamente.

Métodos de codificação em C

Em C#, existem várias maneiras de realizar a codificação de URLs, cada uma adequada para diferentes cenários. Esses métodos são encontrados principalmente nos namespaces System.Web e .NET , oferecendo aos desenvolvedores flexibilidade na forma como codificam URLs. Segue uma breve descrição dos métodos disponíveis:

1. Método HttpUtility.UrlEncode (System.Web): Este é talvez o método mais comumente usado para codificação de URL em uma aplicação web. Ele converte caracteres em um formato codificado em porcentagem, tornando a string segura para transmissão pela URL. É especialmente útil em projetos ASP.NET para codificar strings de consulta e parâmetros de formulário.
2. Método HttpUtility.UrlPathEncode (System.Web): Ao contrário do UrlEncode , o UrlPathEncode foi projetado especificamente para codificar a parte do caminho de uma URL, deixando a string de consulta intacta. É importante notar que esse método não codifica a URL inteira, mas sim a parte do caminho, garantindo que a estrutura hierárquica da URL seja preservada.
3. Método Uri.EscapeUriString (Sistema): Este método destina-se a escapar strings URI, convertendo todos os caracteres não permitidos em uma URI em seus equivalentes codificados em porcentagem. No entanto, não codifica certos caracteres, como a barra ( / ) e o ponto de interrogação ( ? ), porque são considerados caracteres URI válidos.
4. Método Uri.EscapeDataString (Sistema): Este método foi projetado para codificar uma string a ser usada na parte de consulta de um URI. Ele codifica todos os caracteres, exceto os caracteres não reservados definidos na RFC 3986. É mais agressivo que o EscapeUriString , garantindo que os dados sejam codificados com segurança para transmissão em URLs.

Vamos entender os três primeiros métodos de codificação descritos acima e seu funcionamento através da análise de exemplos de código.

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: Biblioteca PDF em C

IronPDF é uma biblioteca PDF que simplifica a criação, edição e manipulação de arquivos PDF em aplicações .NET . Projetado para se integrar perfeitamente com C# e VB .NET, o IronPDF oferece aos desenvolvedores funções para gerar PDFs a partir de HTML ou diretamente de texto. Seja para automatizar a geração de faturas, criar relatórios dinâmicos ou gerenciar documentos em um ambiente .NET , o IronPDF se destaca pela facilidade de uso e pelo conjunto abrangente de recursos.

O grande diferencial do IronPDF é seu recurso de conversão de HTML para PDF , que mantém seus layouts e estilos. Isso permite a criação de PDFs a partir de conteúdo da web, perfeito para relatórios, faturas e documentação. Arquivos HTML, URLs e strings HTML podem ser convertidos facilmente em PDFs.

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

Conclusão

Em resumo, o C# oferece recursos poderosos para codificação e decodificação de URLs, garantindo que os dados possam ser transmitidos pela internet de forma segura e eficiente. Por meio dos métodos integrados nos namespaces System.Web e .NET , os desenvolvedores podem codificar URLs para evitar problemas com caracteres especiais e decodificá-las para sua forma original, garantindo uma interpretação precisa dos dados.

Para aqueles interessados ​​em explorar as ofertas de licença de avaliação do IronPDF , elas proporcionam uma oportunidade de avaliar sua funcionalidade em primeira mão. Caso decida integrar o IronPDF em seus projetos, as licenças começam em $799, oferecendo um conjunto abrangente de recursos para atender às suas necessidades de manipulação de PDF dentro da .NET Framework.