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

C# Dilinde URL Kodlama

Bir URL kodladığınızda, karakterlerini internete güvenli bir şekilde gönderilebilecek bir forma dönüştürürsünüz, yanılgılardan kaçınırsınız. Çünkü URL'ler yalnızca ASCII karakter seti kullanılarak internete gönderilebilir. Bu setin bir parçası olmayan veya URL'lerde özel anlamlara sahip olan karakterler (örneğin, boşluklar, & ve = işaretleri), yüzde kodlaması kullanılarak temsil edilmelidir (örneğin, boşluklar %20 haline gelir). C# bunu başarmak için yerleşik yöntemler sunar.

C# Dilinde URL Çözme

URL çözme, varış noktasına vardığında kodlanmış karakterleri orijinal hallerine dönüştürür. Bu, alıcı uygulamanın veriyi doğru şekilde anlaması ve işlem yapabilmesi için gereklidir. Çözme, yüzde kodlanmış karakterleri yeniden orijinal sembollerine dönüştürür, böylece veri tekrar okunabilir ve kullanılabilir hale gelir.

C# Dilinde Kodlama Yöntemleri

C# dilinde, her biri farklı senaryolar için uygun olan birden fazla URL kodlama yöntemi vardır. Bu yöntemler esas olarak System.Web ve System.Net ad alanlarında bulunur ve geliştiricilere URL'leri nasıl kodlamak istedikleri konusunda esneklik sağlar. İşte mevcut yöntemlerin kısa bir özeti:

1. HttpUtility.UrlEncode Yöntemi (System.Web): Bu, web uygulamalarında URL kodlama için belki de en yaygın kullanılan yöntemdir. Karakterleri yüzde kodlu formata dönüştürerek diziyi 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): UrlEncodeden farklı olarak, UrlPathEncode URL'nin yol kısmını kodlamaya özgüdür, sorgu dizisini dokunulmadan bırakır. Bu yöntem tüm URL'yi değil, yalnızca yol bölümünü kodlar, URL'nin hiyerarşik yapısının korunduğundan emin olur.
3. Uri.EscapeUriString Yöntemi (System): Bu yöntem, URI dizelerini kaçırtmak için tasarlanmıştır ve bir URI'de bulunmasına izin verilmeyen tüm karakterleri yüzde kodlu eşdeğerlerine dönüştürür. Ancak, eğik çizgi (/) ve soru işareti (?) gibi bazı karakterleri kodlamaz, çünkü bunlar geçerli URI karakterleri olarak kabul edilir.
4. Uri.EscapeDataString Yöntemi (System): Bu yöntem, bir URI'nin sorgu bölümünde kullanılacak bir dizeyi kodlamak için tasarlanmıştır. RFC 3986'da tanımlanan serbest bırakılmış karakterler haricindeki tüm karakterleri kodlar. EscapeUriStringden daha agresiftir, verilerin URL'ler içinde güvenli bir şekilde kodlandığından emin olur.

Yukarıda bahsedilen ilk üç kodlama yöntemini anlamak ve nasıl çalıştıklarını kod örneklerini anlatarak görelim.

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ı içinde PDF dosyaları oluşturmayı, düzenlemeyi ve işlemeyi basitleştiren bir PDF kütüphanesidir. C# ve VB.NET ile sorunsuz bir şekilde entegre olacak şekilde tasarlanan IronPDF, geliştiricilere HTML'den PDF veya doğrudan metinden PDF oluşturmayı sağlar. Fatura oluşturmayı otomatikleştirmeniz, dinamik raporlar oluşturmanız veya .NET ortamında belgeleri yönetmeniz gerektiğinde, IronPDF kullanış kolaylığı ve kapsamlı özellik setiyle öne çıkar.

IronPDF'in en önemli özelliği, HTML'yi PDF'ye Dönüştürme özelliği olup, düzenlerinizi ve stillerinizi korur. Bu, web içeriğinden PDF oluşturmayı sağlar ve raporlar, faturalar ve dokümantasyon için mükemmeldir. HTML dosyaları, URL'ler ve HTML dizeleri kolayca PDF'lere 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ç

Sonuç olarak, C#, internet üzerinden güvenli ve verimli bir şekilde veri aktarımını sağlamak için güçlü URL kodlama ve kod çözme yetenekleri sunar. System.Web ve System.Net ad alanlarındaki yerleşik yöntemler sayesinde, geliştiriciler özel karakterlerle ilgili sorunları önlemek için URL'leri kodlayabilir ve doğru veri yorumu için bunları orijinal şekline çözebilir.

Eğer IronPDF Deneme Lisans Teklifleri'ni keşfetmekle ilgileniyorsanız, işlevselliğini yakından değerlendirme fırsatı sunar. IronPDF'i projelerinize entegre etmeye karar verirseniz, lisanslar @$999'dan başlar ve .NET framework içerisinde PDF işleme ihtiyaçlarınızı karşılamak için kapsamlı bir özellik seti sunar.