C# Dictionary Trygetvalue (Geliştiriciler İçin Nasıl Çalışır)

C# Dizin Yapısını Anlamak

C#'de Sözlük'ün ne olduğunu anlamak için TryGetValue yöntemine dalmadan önce önemlidir. Basit terimlerle, bir Dictionary bir anahtar/değer çiftleri koleksiyonudur. Örneğin, anahtarların öğrencilerin isimleri (string değerler) ve öğrencilerin yaşlarının (integer değerler) olduğu bir Dictionary'ye sahip olabilirsiniz.

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}

Bir Dictionary'deki anahtarlar benzersizdir. Anahtarlara erişerek karşılık gelen değeri alabilirsiniz, bu da Dictionary'leri inanılmaz derecede veritabanındaki fonksiyonlar için verimli kılar.

Geleneksel Yaklaşım: ContainsKey Yöntemi

C# Dictionary'leri ile çalışırken, yaygın bir görev belirli bir anahtarla ilişkili bir değeri almaktır. Ancak, var olmayan bir anahtara doğrudan erişmek, programınızın akışını kesintiye uğratan bir KeyNotFoundException fırlatabilir. Bunu önlemek için, belirtilen anahtarın Dictionary içinde olup olmadığını kontrol etmek yaygın bir uygulamadır. Bu noktada ContainsKey yöntemi devreye girer.

ContainsKey yöntemi, belirli bir anahtarın Sözlükte olup olmadığını kontrol eden basit ve sezgisel bir işlevdir. İşte ContainsKey yönteminin temel sözdizimi:

Dictionary<TKey, TValue>.ContainsKey(TKey key)

Dictionary<TKey, TValue>.ContainsKey(TKey key)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Dictionary<TKey, TValue>.ContainsKey(TKey key)

Anahtarı bir parametre olarak alır ve bir Boolean değeri döndürür. Anahtar Sözlükte ise, true döndürecektir; değilse, false döndürecektir.

Öğrenci isimleri anahtarları ve karşılık gelen yaşları değerleri olarak içeren bir Dictionary örneğini düşünün.

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}

Şimdi, 'Alice' adlı bir öğrencinin yaşını almak istiyorsanız, önce ContainsKey yöntemini kullanarak 'Alice'in Sözlükte bir anahtar olup olmadığını kontrol edersiniz.

string student = "Alice";
if (studentAges.ContainsKey(student))
{
    int age = studentAges[student];
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

string student = "Alice";
if (studentAges.ContainsKey(student))
{
    int age = studentAges[student];
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

Dim student As String = "Alice"
If studentAges.ContainsKey(student) Then
	Dim age As Integer = studentAges(student)
	Console.WriteLine($"{student} is {age} years old.")
Else
	Console.WriteLine($"{student} does not exist in the dictionary.")
End If

Bu durumda program 'Alice 20 yaşında.' yazdıracaktır. Sözlükte bulunmayan bir öğrencinin yaşını almaya çalıştığınızda ise, ContainsKey yöntemi bir KeyNotFoundException fırlatılmasını önleyecek ve bunun yerine öğrencinin mevcut olmadığını belirten bir mesaj yazdıracaktır.

Ancak, ContainsKey yöntemi faydalı olabilirken, her zaman en verimli değil çünkü Sözlük üzerinde iki arama işlemi gerçekleştiriliyor: biri ContainsKey yöntemi için, diğeri değeri almak için. Bu, özellikle büyük Dictionary'lerle çalışırken zaman alıcı olabilir.

ContainsKey yöntemi, bir Sözlükte belirtilen bir anahtar bulunamadığında istisnaları yönetmenin basit ve sezgisel bir yolu olurken, benzer işlevselliği daha iyi performansla sağlayabilecek TryGetValue gibi alternatif yöntemleri düşünmeye değer. TryGetValue konusunda detayları ilerleyen bölümlerde tartışacağız.

Dogrulama ve Almayı TryGetValue ile Birleştirme

Bu noktada TryGetValue yöntemi kullanışlı hale gelir. TryGetValue yöntemi, tek bir adımda doğrulamayı ve değer almayı birleştirerek neredeyse aynı kod işlevselliği sunar ama daha yüksek performansla.

TryGetValue yöntemi iki parametre gerektirir:

1. Aradığınız anahtar.
2. Anahtar varsa değeri tutacak bir out parametresi.

İşte sözdizimi:

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

out anahtar kelimesi, bu yöntemin value parametresini değiştireceğini belirtmek için kullanılır. Eğer belirtilen anahtar bulunmazsa, out türünün varsayılan değeri olacaktır (integer'lar için 0, referans türleri için null). Aksi takdirde, sağlanan anahtara karşılık gelen değeri tutar.

TryGetValue kullanımı şu şekildedir:

string student = "Alice";
if (studentAges.TryGetValue(student, out int age))
{
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

string student = "Alice";
if (studentAges.TryGetValue(student, out int age))
{
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

Dim student As String = "Alice"
Dim age As Integer
If studentAges.TryGetValue(student, age) Then
	Console.WriteLine($"{student} is {age} years old.")
Else
	Console.WriteLine($"{student} does not exist in the dictionary.")
End If

Bu kod, ContainsKey yöntem örneğine neredeyse aynı işlevsellik sağlar ama daha verimlidir çünkü anahtarı yalnızca bir kez arar.

TryGetValue Uygulamada Kod Örneği

TryGetValue yöntemini daha iyi anlamak için pratik bir kod örneği inceleyelim. Her öğrencinin benzersiz bir kimliği ve karşılık gelen bir adı olan bir okul veritabanını düşünün. Bu veriler, öğrenci kimlik numarası anahtar olarak ve ad olarak değer olan bir Dictionary'de depolanmıştır.

Dictionary<int, string> studentNames = new Dictionary<int, string>
{
    {1, "Alice"},
    {2, "Bob"},
    {3, "Charlie"}
};

Dictionary<int, string> studentNames = new Dictionary<int, string>
{
    {1, "Alice"},
    {2, "Bob"},
    {3, "Charlie"}
};

Dim studentNames As New Dictionary(Of Integer, String) From {
	{1, "Alice"},
	{2, "Bob"},
	{3, "Charlie"}
}

Bu durumda, 2 numaralı kimlik ile öğrencinin adını almak istersiniz ancak aynı zamanda bu kimlik numarasına sahip öğrencinin veritabanında mevcut olduğundan emin olmak istersiniz.

Geleneksel olarak, anahtarın (öğrenci ID'si 2) var olup olmadığını kontrol etmek için önce ContainsKey yöntemini, ardından da karşılık gelen değeri almak için Sözlüğe erişebilirsiniz. Ancak, TryGetValue yöntemi ile bunu tek bir adımda başarabilirsiniz.

TryGetValue yöntemi iki argüman alır: aradığınız anahtar ve bu anahtarın var olması halinde bu anahtara sahip değeri tutacak out parametresi. Anahtar bulunursa, yöntem true döndürür ve karşılık gelen değeri out parametresine atar. Bulunmadığında, false döndürecektir ve out parametresi türünün varsayılan değerini alacaktır.

int i = 2; // Student ID
if (studentNames.TryGetValue(i, out string value))
{
    Console.WriteLine($"The name of the student with ID {i} is {value}.");
}
else
{
    Console.WriteLine($"No student with ID {i} exists in the dictionary.");
}

int i = 2; // Student ID
if (studentNames.TryGetValue(i, out string value))
{
    Console.WriteLine($"The name of the student with ID {i} is {value}.");
}
else
{
    Console.WriteLine($"No student with ID {i} exists in the dictionary.");
}

Dim i As Integer = 2 ' Student ID
Dim value As String
If studentNames.TryGetValue(i, value) Then
	Console.WriteLine($"The name of the student with ID {i} is {value}.")
Else
	Console.WriteLine($"No student with ID {i} exists in the dictionary.")
End If

Bu durumda, TryGetValue yöntemi studentNames Sözlüğünde anahtar 2'yi arar. Anahtarı bulursa, karşılık gelen değeri value değişkenine (öğrencinin adı) atar ve yöntem true döndürür. Sonra, program "2 numaralı kimliğe sahip öğrencinin adı Bob'dur." ifadesini çıktı verir.

TryGetValue yöntemi anahtar 2'yi bulamazsa, bir string (ki bu null'dur) için varsayılan değeri value değişkenine atar ve yöntem false döndürür. Kod ardından else bloğuna geçer ve 'Sözlükte ID 2 olan bir öğrenci yok.' yazdırır.

TryGetValue, anahtar varlığı kontrolü ve değer almayı tek bir adımda birleştirerek kodunuzu basit hale getirir. Ayrıca, daha büyük Sözlüklerde performans artışı sağlar çünkü birden fazla anahtar arama işlemi gereğini ortadan kaldırır.

Iron Suite Tanıtımı

C# yolculuğunuzda ilerlerken, programlama yeteneklerinizi önemli ölçüde geliştirebilecek birçok araç ve kütüphaneyi elinizin altında bulacaksınız. Bu araçlar arasında, C# uygulamalarının işlevselliğini genişletmek için özel olarak tasarlanmış Iron kitaplıkları bulunur. Bu kitaplıklar arasında IronPDF, IronXL, IronOCR ve IronBarcode yer alır. Her birinin benzersiz bir dizi işlevi vardır ve standart C# ile birlikte kullanıldığında önemli avantajlar sağlarlar.

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

Sonuç

Iron kütüphanelerinin işlevselliklerini standart C# özellikleriyle birlikte TryGetValue yöntemi gibi incelediğimizde, bu araçların geliştirme sürecinizi önemli ölçüde artırabileceği açıktır. PDF'ler, Excel dosyaları, OCR veya Barkodlarla çalışırken, Iron Suite ihtiyaçlarınıza uygun bir çözüm sunar.

Daha da cazip olanı, bu ürünlerin her biri Iron Software ürünleri için ücretsiz bir deneme sunarak özelliklerini maliyetsiz olarak keşfetmenize ve denemenize olanak tanır. Kütüphaneleri kullanmaya devam etmeye karar verirseniz, her bir ürün için lisans $999 ile başlar. Ancak, birden fazla Iron kütüphanesiyle ilgileniyorsanız, sadece iki bireysel ürünün fiyatına tam Iron Suite'i satın alarak daha fazla değer bulabilirsiniz.