Kodowanie i dekodowanie adresów URL to techniki stosowane w języku C# w celu zapewnienia bezpiecznej transmisji danych w ramach adresów URL. W języku C# operacje te są powszechnie spotykane podczas pracy z aplikacjami internetowymi, wywołaniami API lub w każdym scenariuszu, w którym dane muszą być przesyłane przez Internet w sposób bezpieczny i niezawodny. W tym artykułe omówimy metodę kodowania adresów URL oraz bibliotekę IronPDF.
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 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.
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:
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);
}
}Imports System
Imports System.Web
Module Program
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 Function UrlEncode(originalString As String) As String
Return HttpUtility.UrlEncode(originalString)
End Function
End ModuleWłączenie przestrzeni nazw: Przestrzeń nazw System.Web jest dołączona na początku kodu.
Oryginalny ciąg znaków: Definiujemy zmienną typu string o nazwie originalString zawierającą znaki, które należy zakodować w celu bezpiecznej transmisji w adresie URL. Dotyczy to również spacji i znaków interpunkcyjnych, które mogłyby potencjalnie powodować problemy, gdyby znalazły się w adresie URL bez kodowania.
Kodowanie: Metoda HttpUtility.UrlEncode jest wywoływana z argumentem originalString. Ta metoda przetwarza ciąg znaków i zwraca nowy ciąg, w którym niebezpieczne znaki są zastępowane ich odpowiednikami zakodowanymi w formacie procentowym. Na przykład spacje są zastępowane znakiem %20.
Wynik: Na koniec program PRINTuje na konsoli zarówno oryginalne, jak i zakodowane ciągi znaków.
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
Module Program
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 ModuleOdpowiedniki znaków w kodowaniu adresów URL: Przedstawiony proces przekształca wartość ciągu znaków ścieżki adresu URL, zamieniając spacje na ich odpowiedniki znaków (%20) w celu zapewnienia zgodności z siecią. Jest to kluczowe, ponieważ adresy URL nie mogą zawierać rzeczywistych znaków spacji.
Obsługa wartości ciągów znaków i ciągów URL: Wartość ciągu znaków zmiennej originalPath to "/api/search/Hello World!", co jest typowym przykładem ciągu URL wymagającego kodowania ze względu na obecność spacji.
Chociaż w tym przykładzie użyto konkretnej wersji metody HttpUtility.UrlPathEncode bez przeciążenia, należy zwrócić uwagę na zamierzoną funkcję tej metody, jaką jest kodowanie ścieżek URL. Programiści powinni być świadomi istnienia przeciążenia metod, ponieważ zapewnia ono alternatywne sposoby korzystania z danej metody, często poprzez akceptowanie różnych typów danych wejściowych lub zapewnianie dodatkowej funkcjonalności.
Obiekt kodujący i transformacja adresu URL typu string: Obiekt kodujący w tym kontekście jest domyślnie zawarty w działaniu metody HttpUtility.UrlPathEncode, która pobiera adres URL typu string i zwraca jego zakodowaną formę. Ta metoda gwarantuje, że struktura ścieżki URL pozostaje nienaruszona, a znaki specjalne są kodowane do odpowiednich reprezentacji.
Wynik zakodowanej ścieżki: Program pokazuje przekształcenie oryginalnej ścieżki w ścieżkę zakodowaną. Jest to bezpośredni przykład kodowania ciągu znaków URL w celu dostosowania go do transmisji internetowej, uwzględniający potencjalne problemy, jakie mogą powodować spacje i inne znaki specjalne.
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
Module Program
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 ModuleOryginalny URI: Zmienna originalUri jest inicjowana ciągiem znaków reprezentującym pełny adres URI, w tym ciąg zapytania zawierający spacje i znaki specjalne. Aby zapewnić prawidłowe przetwarzanie adresu URI przez przeglądarki internetowe i serwery, znaki specjalne muszą zostać "eskapowane".
Eskapowanie adresu URI: Metoda Uri.EscapeUriString jest wywoływana z argumentem originalUri. Ta metoda skanuje ciąg URI i zamienia znaki, które są niedozwolone lub mogą powodować niejasności w URI.
Wynik: Program wyświetla na konsoli zarówno oryginalny, jak i zakodowany adres URI.
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");
}
}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 ClassW poniższym przykładzie zobaczymy, jak używać IronPDF w połączeniu z kodowaniem URL do generowania pliku PDF ze strony internetowej. Scenariusz obejmuje kodowanie adresu URL w celu zapewnienia jego prawidłowego formatowania dla żądań internetowych, a następnie użycie IronPDF do konwersji treści pod tym adresem URL na dokument PDF.
Najpierw upewnij się, że masz zainstalowany IronPDF w swoim projekcie. Jeśli korzystasz z menedżera pakietów NuGet, możesz zainstalować go, uruchamiając:
Przejdźmy teraz do kodu:
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
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
Przykład zaczyna się od podstawowego adresu URL i ciągu zapytania zawierającego spacje. Ciąg zapytania jest kodowany przy użyciu HttpUtility.UrlEncode, aby zapewnić jego bezpieczną transmisję w adresie URL. Po zakodowaniu zapytania jest ono dołączane do podstawowego adresu URL, tworząc pełny adres URL, do którego zostanie nawiązany dostęp.
Po przygotowaniu pełnego, zakodowanego adresu URL, ChromePdfRenderer firmy IronPDF służy do pobrania strony internetowej pod tym adresem i przekształcenia jej w dokument PDF. Wymaga to utworzenia instancji klasy ChromePdfRenderer, a następnie wywołania metody RenderUrlAsPdf z zakodowanym adresem URL. Na koniec wygenerowany plik PDF jest zapisywany przy użyciu metody SaveAs. Plikem wynikowym jest dokument PDF zawierający treść strony internetowej, dostępny poprzez zakodowany adres URL. Oto plik PDF z tłumaczeniem:
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 z twoimi projektami, licencje zaczynają się od $999, oferując wszechstronny zestaw funkcji, który sprosta Twoim potrzebom manipulacji PDF w ramach .NET.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
