C# URL Encode (Geliştiriciler için Nasıl Çalışır)

C#'da URL Kodlama

Bir URL'yi kodladığınızda, karakterlerini internette güvenli bir şekilde gönderilebilecek bir forma dönüştürürsünüz ve yanlış anlaşılmalardan kaçınırsınız. Bu, çünkü URL'ler yalnızca ASCII karakter setini kullanarak internet üzerinden gönderilebilir. Bu sete dahil olmayan veya URL'lerde özel anlam taşıyan karakterler (boşluklar, & ve = gibi) yüzdeli kodlama kullanılarak temsil edilmelidir (örn. boşluklar %20 olur). C#, bu görevi gerçekleştirmek için yerleşik yöntemler sunar.

C#'da URL Kodunu Çözme

URL kodunu çözme, kodlanmış karakterleri varış yerinde orijinal hallerine dönüştürür. Bu, alıcı uygulamanın veriyi amaçlandığı gibi doğru bir şekilde anlaması ve işlemesi için gereklidir. Kod çözme, yüzdeli kodlanmış karakterleri orijinal sembollerine geri çevirir ve veriyi tekrar okunabilir ve kullanılabilir hale getirir.

C#'da Kodlama Yöntemleri

C#'da, farklı senaryolar için uygun birçok URL kodlama yöntemi vardır. Bu yöntemler öncelikli olarak System.Web ve System.Net ad alanlarında bulunur ve geliştiricilere URL'leri nasıl kodlayacakları konusunda esneklik sunar. İşte mevcut yöntemlerin kısa bir özeti:

1. HttpUtility.UrlEncode Yöntemi (System.Web): Bu, muhtemelen bir web uygulamasında URL kodlaması için en sık kullanılan yöntemdir. Karakterleri yüzdeli kodlanmış bir formata dönüştürür ve dizeyi URL üzerinden iletim için güvenli hale getirir. Özellikle, ASP.NET projelerinde sorgu dizeleri ve form parametrelerini kodlamak için kullanışlıdır.
2. HttpUtility.UrlPathEncode Yöntemi (System.Web): UrlEncode'dan farklı olarak, UrlPathEncode özellikle bir URL'nin yol kısmını kodlamak için tasarlanmıştır ve sorgu dizelerine dokunmaz. Bu yöntem, tüm URL'yi değil sadece yol kısmını kodlar ve böylece URL'nin hiyerarşik yapısının korunmasını sağlar.
3. Uri.EscapeUriString Yöntemi (System): Bu yöntem, bir URI'de izin verilmeyen tüm karakterleri yüzdeli kodlanmış eşdeğerleriyle dönüşüme uğratarak URI dizgi kaçışını amaçlar. Ancak, geçerli URI karakterleri olarak değerlendirilen eğik çizgi (/) ve soru işareti (?) gibi bazı karakterleri kodlamaz.
4. Uri.EscapeDataString Yöntemi (System): Bu yöntem, bir URI'nin sorgu kısmında kullanılacak bir diziyi kodlamak için tasarlanmıştır. RFC 3986'de tanımlanan münferit karakterler hariç tüm karakterleri kodlar. Bu, EscapeUriString'den daha saldırgan olup, verinin URL'ler içinde iletim için güvenli bir şekilde kodlanmasını sağlar.

Yukarıda tarif edilen ilk üç kodlama yöntemini ve çalışma şekillerini kod örnekleri aracılığıyla anlayalım.

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 Kütüphanesi

IronPDF, .NET uygulamalarında PDF dosyaları oluşturmayı, düzenlemeyi ve manipüle etmeyi basitleştiren bir PDF kütüphanesidir. C# ve VB.NET ile kesintisiz bir şekilde entegre olacak şekilde tasarlanan IronPDF, geliştiricilere HTML'den PDF oluşturma veya doğrudan metinden PDF oluşturma fonksiyonları sunar. Fatura oluşturmayı otomatikleştirme, dinamik raporlar oluşturma veya bir .NET ortamında belgeleri yönetme ihtiyaçınız olsun, IronPDF kullanım kolaylığı ve kapsamlı özellik seti ile öne çıkar.

IronPDF'nin öne çıkan özelliği, layouts ve stillerinizi koruyan HTML'den PDF'ye Dönüştürme özelliğidir. Bu, PDF'lerin web içeriğinden oluşturulmasına olanak sağlar, raporlar, faturalar ve dokümantasyon için mükemmeldir. HTML dosyaları, URL'ler ve HTML dizgileri kolayca PDF'ye dönüştürülebilir.

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

Sonuç

Özetlemek gerekirse, C#, internet üzerinden verilerin güvenli ve etkili bir şekilde iletilmesini sağlamak için güçlü URL kodlama ve işaret çözme yetenekleri sağlar. System.Web ve System.Net ad alanlarındaki yerleşik yöntemlerle, geliştiriciler, özel karakterlerle ilgili sorunları önlemek için URL'leri kodlayabilir ve doğru veri yorumlaması için bunları orijinal formlarına çözüp çözebilir.

IronPDF Deneme Lisans Tekliflerini keşfetmekle ilgilenenler için, işlevselliğini ilk elden değerlendirme fırsatı sunarlar. Projelerinize IronPDF'i entegre etmeye karar verirseniz, lisanslar $799'den başlar ve .NET çerçevesinde PDF manipülasyon ihtiyaçlarınızı karşılamak için kapsamlı bir özellik paketi sunar.