Kodowanie adresów URL w języku C# (jak to działa dla programistów)

Kodowanie adresów URL w języku C

Kiedy kodujesz adres URL, zmieniasz jego znaki na formę, którą można bezpiecznie przesłać przez Internet, unikając nieporozumień. Wynika to z faktu, że adresy URL mogą być przesyłane przez Internet wyłącznie przy użyciu zestawu znaków ASCII. Znaki, które nie należą do tego zestawu lub mają specjalne znaczenie w adresach URL (takie jak spacje, znaki "&" i znaki równości), muszą być przedstawione przy użyciu kodowania procentowego (np. spacje stają się %20). Język C# udostępnia wbudowane metody umożliwiające realizację tego zadania.

Dekodowanie adresów URL w języku C

Dekodowanie adresów URL przekształca zakodowane znaki z powrotem do ich pierwotnego stanu po dotarciu do miejsca docelowego. Ma to zasadnicze znaczenie dla prawidłowego zrozumienia i przetworzenia danych przez aplikację docelową zgodnie z zamierzeniami. Dekodowanie zamienia znaki zakodowane w formacie procentowym z powrotem na ich oryginalne symbole, dzięki czemu dane stają się ponownie czytelne i użyteczne.

Metody kodowania w języku C

W języku C# istnieje wiele sposobów kodowania adresów URL, z których każdy jest dostosowany do różnych scenariuszy. Metody te znajdują się głównie w przestrzeniach nazw System.Web i System.Net, oferując programistom elastyczność w sposobie kodowania adresów URL. Oto krótki przegląd dostępnych metod:

1. Metoda HttpUtility.UrlEncode (System.Web): Jest to prawdopodobnie najczęściej stosowana metoda kodowania adresów URL w aplikacjach internetowych. Konwertuje znaki na format zakodowany procentowo, dzięki czemu ciąg znaków jest bezpieczny do przesyłania w adresie URL. Jest to szczególnie przydatne w projektach ASP.NET do kodowania ciągów zapytań i parametrów formularzy.
2. Metoda HttpUtility.UrlPathEncode (System.Web): W przeciwieństwie do UrlEncode, UrlPathEncode jest przeznaczona specjalnie do kodowania części ścieżki adresu URL, pozostawiając ciąg zapytania bez zmian. Należy pamiętać, że ta metoda nie koduje całego adresu URL, a jedynie część ścieżki, co pozwala zachować hierarchiczną strukturę adresu.
3. Metoda Uri.EscapeUriString (System): Ta metoda służy do escapowania ciągów URI, zamieniając wszystkie znaki niedozwolone w URI na ich odpowiedniki zakodowane procentowo. Nie koduje jednak niektórych znaków, takich jak ukośnik (/) i znak zapytania (?), ponieważ są one uznawane za prawidłowe znaki URI.
4. Metoda Uri.EscapeDataString (System): Ta metoda służy do kodowania ciągu znaków, który ma być użyty w części zapytania adresu URI. Koduje wszystkie znaki z wyjątkiem znaków niezarezerwowanych zdefiniowanych w RFC 3986. Działa bardziej agresywnie niż EscapeUriString, zapewniając bezpieczne zakodowanie danych do transmisji w adresach URL.

Przyjrzyjmy się trzem pierwszym metodom kodowania opisanym powyżej oraz ich działaniu na podstawie przykładów kodu.

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: biblioteka PDF dla języka C

IronPDF to biblioteka PDF, która ułatwia tworzenie, edycję i obróbkę plików PDF w aplikacjach .NET. Zaprojektowany z myślą o płynnej integracji z C# i VB.NET, IronPDF oferuje programistom funkcje generowania plików PDF z HTML lub bezpośrednio z tekstu. Niezależnie od tego, czy potrzebujesz zautomatyzować generowanie faktur, tworzyć dynamiczne raporty, czy zarządzać dokumentami w środowisku .NET, IronPDF wyróżnia się łatwością obsługi i kompleksowym zestawem funkcji.

Najważniejszą cechą IronPDF jest funkcja konwersji HTML do PDF, która zachowuje układ i style. Umożliwia to tworzenie plików PDF na podstawie treści internetowych, co idealnie sprawdza się w przypadku raportów, faktur i dokumentacji. Pliki HTML, adresy URL i ciągi znaków HTML można łatwo konwertować do formatu 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

Wnioski

Podsumowując, język C# zapewnia zaawansowane możliwości kodowania i dekodowania adresów URL, gwarantując bezpieczną i wydajną transmisję danych przez Internet. Dzięki wbudowanym metodom w przestrzeniach nazw System.Web i System.Net programiści mogą kodować adresy URL, aby zapobiec problemom ze znakami specjalnymi, oraz dekodować je do ich pierwotnej postaci w celu dokładnej interpretacji danych.

Osoby zainteresowane ofertą licencji Trial IronPDF mają możliwość osobistego przetestowania ich funkcjonalności. Jeśli zdecydujesz się zintegrować IronPDF ze swoimi projektami, ceny licencji zaczynają się od $799, oferując kompleksową Suite funkcji spełniających Twoje potrzeby w zakresie obróbki plików PDF w środowisku .NET Framework.