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

C# Dictionary'nin Temellerini Anlama

C#'te bir Dictionary'nin ne olduğunu anlamak, TryGetValue yöntemine dalmadan önce kritik önemdedir. Basitçe ifade edilirse, bir Dictionary, anahtar/değer çiftlerinden oluşan bir koleksiyondur. Örneğin, anahtarların öğrenci isimlerini (string değerler) ve değerlerin bu öğrencilere karşılık gelen yaşlarını (integer değerler) temsil ettiği 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. Dictionary'ler, erişim anahtarları kullanılarak karşılık gelen değerin alınmasını sağlayarak, arama işlevselliğinde oldukça verimli hale gelir.

Geleneksel Yaklaşım: ContainsKey Yöntemi

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

ContainsKey yöntemi, belirli bir anahtarın Dictionary'de mevcut olup olmadığını kontrol eden basit ve sezgisel bir fonksiyondur. ContainsKey yönteminin temel söz dizimi aşağıdaki gibidir:

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 Dictionary'de mevcutsa, true dönecektir; değilse, false dönecektir.

Anahtar olarak öğrenci adlarını ve değer olarak yaşlarını 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" adında bir öğrencinin yaşını almak istiyorsanız, önce "Alice" in Dictionary'de bir anahtar olup olmadığını kontrol etmek için ContainsKey yöntemini kullanmanız gerekir.

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. Dictionary'de mevcut olmayan bir öğrencinin yaşını almaya çalışırsanız, ContainsKey yöntemi bir KeyNotFoundException fırlatılmasını engelleyecek ve bunun yerine öğrencinin mevcut olmadığını bildiren bir mesaj yazdıracaktır.

Ancak, ContainsKey yöntemi yararlı olabilirken, Dictionary üzerinde iki arama işlemi yapıldığı için her zaman en verimli yöntem değildir: biri ContainsKey yöntemi için, diğeri ise değeri almak için. Bu özellikle büyük Dictionary'lerle karşılaşıldığında zaman alıcı olabilir.

ContainsKey yöntemi, Dictionary'de belirtilen bir anahtar bulunamadığında istisnaları basit ve sezgisel bir şekilde ele alırken, benzer işlevselliği daha iyi performansla elde edebilecek alternatif yöntemler, örneğin TryGetValue, düşünülmeye değerdir. TryGetValue konusunu sonraki bölümlerde daha ayrıntılı olarak ele alacağız.

Doğrulama ve Almayı TryGetValue ile Birleştirmek

TryGetValue yöntemi burada oldukça kullanışlıdır. TryGetValue yöntemi, doğrulama ve değer alımını tek bir adımda birleştirerek neredeyse aynı kod işlevselliği sunar, ancak geliştirilmiş performans sağlar.

TryGetValue yöntemi iki parametre gerektirir:

1. Aradığınız anahtar.
2. Eğer anahtar var ise değeri tutacak bir out parametre.

İşte söz dizimi:

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. out değeri, belirtilen anahtar bulunamazsa değer türünün varsayılan değeri olacaktır (tam sayılar için 0, referans türleri için null). Aksi takdirde, sağlanan anahtara karşılık gelen değeri tutacaktır.

TryGetValue kullanım şekli şöyledir:

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öntemi örneğiyle neredeyse aynı işlevselliği sağlar, ancak anahtarı yalnızca bir kez aradığı için daha verimlidir.

TryGetValue Uygulamalı 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 isminin bulunduğu bir okul veri tabanı düşünün. Bu veriler, öğrenci kimliği anahtar ve isim değer olarak olmak üzere bir Dictionary'de saklanı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, kimliği 2 olan öğrencinin adını almak istiyor ancak bu kimliğe sahip öğrencinin veri tabanında var olduğundan emin olmak istiyorsanız.

Geleneksel olarak, öncelikle ContainsKey yöntemini kullanarak anahtarın (öğrenci ID 2) olup olmadığını kontrol edebilir ve ardından ilgili değeri (öğrenci ismi) almak için Dictionary'e erişebilirsiniz. Ancak, TryGetValue yöntemiyle bunu tek bir adımda gerçekleştirebilirsiniz.

TryGetValue yöntemi iki argüman alır: aradığınız anahtar ve o anahtarla ilişkili değeri kapsayacak out parametresi. Anahtar bulunursa, yöntem true dönecek ve ilgili değeri out parametresine atayacaktır. Bulunamazsa, false dönecek ve out parametresi, türü için varsayılan değeri 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 Dictionary'de anahtar 2'yi arar. Anahtarı bulursa, ilgili değeri value değişkenine (öğrenci ismi) atar ve yöntem true döner. "ID'si 2 olan öğrencinin adı Bob'dur." şeklinde yapılandırılmış bir metin çıktısını program yazdırır.

TryGetValue yöntemi anahtar 2'yi bulamazsa, value değişkenine bir dizginin varsayılan değeri olan null'u atar ve yöntem false döner. Kod daha sonra else bloğuna girer ve, "Dictionary'de ID 2 olan bir öğrenci yok." yazdırılır.

TryGetValue, anahtarın varlığını kontrol etme ve değeri alma işlemini tek bir adımda birleştirerek kodunuzu kolaylaştırır. Ayrıca, özellikle daha büyük Dictionary'lerde, birden fazla anahtar arama işlemini ortadan kaldırarak performans artışı sağlar.

Iron Suite'i Tanıtıyoruz

C# serüveninizde ilerlemeye devam ettikçe, programlama yeteneklerinizi önemli ölçüde artırabilecek birçok araç ve kütüphane olduğunu göreceksiniz. Bunlar arasında, C# uygulamalarının işlevselliğini genişletmek üzere özel olarak tasarlanmış Iron kütüphaneleri de yer alır. IronPDF, IronXL, IronOCR ve IronBarcode bu kütüphaneler arasındadır. Bu kütüphanelerin her biri kendine özgü bir dizi işlevselliğe sahiptir ve standart C# ile birlikte kullanıldığında önemli avantajlar sunarlar.

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şlevselliğini standart C# özellikleriyle, örneğin TryGetValue yöntemi gibi, birleştirdiğimizde, bu araçların geliştirme sürecinizi önemli ölçüde artırabileceği açıkça görülmektedir. İster PDF'ler, Excel dosyaları, OCR veya Barkodlarla çalışıyor olun, Iron Suite ihtiyaçlarınıza uygun bir çözüm sunar.

Iron Software Ürünleri için ücretsiz deneme sunulması daha da caziptir, böylece özellikleri ek bir maliyet olmadan keşfetme ve deneme fırsatına sahip olabilirsiniz. Eğer kütüphaneleri kullanmaya devam etmeye karar verirseniz, her bir ürün için lisans $799 'den başlamaktadır. Ancak, birden fazla Iron kütüphanesi ile ilgileniyorsanız, tüm Iron Suite'i sadece iki ayrı ürün fiyatına satın alabilirsiniz.