C# Dictionary Trygetvalue (Wie es für Entwickler funktioniert)

Grundlagen des C#-Wörterbuchs verstehen

Bevor wir uns mit der Methode TryGetValue befassen, ist es wichtig zu verstehen, was ein Dictionary in C# ist. Einfach ausgedrückt ist ein Dictionary eine Sammlung von Schlüssel/Wert-Paaren. Zum Beispiel könnte man ein Dictionary haben, bei dem die Schlüssel die Namen der Schüler (String-Werte) und die Werte deren jeweiliges Alter (Integer-Werte) sind.

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}
}

Die Schlüssel in einem Dictionary sind eindeutig. Man kann auf Schlüssel zugreifen, um den entsprechenden Wert abzurufen, wodurch Dictionaries besonders effizient für Suchfunktionen sind.

Der konventionelle Ansatz: ContainsKey Methode

Beim Arbeiten mit C# Dictionaries ist es eine übliche Aufgabe, einen Wert abzurufen, der einem bestimmten Schlüssel zugeordnet ist. Der direkte Zugriff auf einen nicht existierenden Schlüssel kann jedoch einen KeyNotFoundException-Fehler auslösen und den Programmablauf unterbrechen. Um dies zu vermeiden, ist es gängige Praxis zu überprüfen, ob der angegebene Schlüssel im Dictionary vorhanden ist. Hier kommt die Methode ContainsKey ins Spiel.

Die Methode ContainsKey ist eine einfache und intuitive Funktion, die prüft, ob ein bestimmter Schlüssel im Wörterbuch vorhanden ist. Hier ist die grundlegende Syntax der ContainsKey Methode:

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)

Sie nimmt den Schlüssel als Parameter und gibt einen Boolean-Wert zurück. Wenn der Schlüssel im Wörterbuch vorhanden ist, wird true zurückgegeben; Andernfalls wird false zurückgegeben.

Betrachten Sie das folgende Beispiel, bei dem wir ein Dictionary mit Schülernamen als Schlüsseln und deren entsprechendes Alter als Werten haben.

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}
}

Wenn Sie nun das Alter einer Schülerin namens "Alice" erfahren möchten, würden Sie zuerst die Methode ContainsKey verwenden, um zu prüfen, ob "Alice" ein Schlüssel im Wörterbuch ist.

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

In diesem Fall gibt das Programm "Alice ist 20 Jahre alt" aus. Wenn Sie versuchen, das Alter eines Schülers abzurufen, der nicht im Wörterbuch vorhanden ist, würde die Methode ContainsKey verhindern, dass ein KeyNotFoundException ausgelöst wird, und stattdessen eine Meldung ausgeben, dass der Schüler nicht existiert.

Die Methode ContainsKey kann zwar nützlich sein, ist aber nicht immer die effizienteste, da zwei Suchvorgänge im Wörterbuch durchgeführt werden: einer für die Methode ContainsKey und einer zum Abrufen des Werts. Dies kann zeitaufwendig sein, insbesondere wenn man mit großen Dictionaries arbeitet.

Während die Methode ContainsKey eine einfache und intuitive Möglichkeit darstellt, Ausnahmen zu behandeln, wenn ein bestimmter Schlüssel in einem Wörterbuch nicht gefunden wird, lohnt es sich, alternative Methoden wie TryGetValue in Betracht zu ziehen, die eine ähnliche Funktionalität mit besserer Leistung erreichen können. Wir werden TryGetValue in den folgenden Abschnitten genauer besprechen.

Kombination von Verifizierung und Abruf mit TryGetValue

Hier kommt die Methode TryGetValue ins Spiel. Die Methode TryGetValue kombiniert die Verifizierung und den Wertabruf in einem einzigen Schritt und bietet nahezu identische Code-Funktionalität bei gleichzeitig verbesserter Leistung.

Die Methode TryGetValue benötigt zwei Parameter:

1. Der gesuchte Schlüssel.
2. Ein out-Parameter, der den Wert hält, wenn der Schlüssel existiert.

Hier ist die Syntax:

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)

Das Schlüsselwort out wird verwendet, um anzuzeigen, dass diese Methode den Parameter value ändert. Der Wert out wird als Standardwert des Werttyps verwendet, wenn der angegebene Schlüssel nicht gefunden wird (0 für ganze Zahlen, null für Referenztypen). Andernfalls enthält er den Wert, der dem angegebenen Schlüssel entspricht.

Hier erfahren Sie, wie Sie TryGetValue verwenden:

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

Dieser Code bietet eine nahezu identische Funktionalität wie das Methodenbeispiel ContainsKey, ist aber effizienter, da der Schlüssel nur einmal nachgeschlagen wird.

TryGetValue Codebeispiel in Aktion

Um die Methode TryGetValue besser zu verstehen, wollen wir uns ein praktisches Codebeispiel ansehen. Betrachten Sie eine Schuldatenbank, in der jeder Schüler eine eindeutige ID und einen entsprechenden Namen hat. Diese Daten werden in einem Dictionary mit der Schüler-ID als Schlüssel und dem Namen als Wert gespeichert.

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"}
}

In diesem Fall wollen Sie den Namen des Schülers mit ID 2 abrufen, möchten aber auch sicherstellen, dass der Schüler mit dieser ID in der Datenbank existiert.

Traditionell würde man zuerst die Methode ContainsKey verwenden, um zu prüfen, ob der Schlüssel (Studenten-ID 2) existiert, und dann auf das Wörterbuch zugreifen, um den entsprechenden Wert (Studentenname) zu erhalten. Mit der Methode TryGetValue lässt sich dies jedoch in einem einzigen Schritt erreichen.

Die Methode TryGetValue benötigt zwei Argumente: den gesuchten Schlüssel und einen Parameter out, der den zu diesem Schlüssel gehörenden Wert enthält, falls dieser existiert. Wenn der Schlüssel gefunden wird, gibt die Methode true zurück und weist dem Parameter out den entsprechenden Wert zu. Andernfalls wird false zurückgegeben, und der Parameter out nimmt den Standardwert für seinen Typ an.

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

In diesem Fall sucht die Methode TryGetValue nach dem Schlüssel 2 im Wörterbuch studentNames. Wenn der Schlüssel gefunden wird, weist die Methode der Variablen value (dem Namen des Studenten) den entsprechenden Wert zu und gibt true zurück. Dann druckt das Programm: "Der Name des Schülers mit ID 2 ist Bob."

Wenn die Methode TryGetValue den Schlüssel 2 nicht findet, weist sie der Variablen value den Standardwert für eine Zeichenkette (der null ist) zu und gibt false zurück. Der Code springt dann zum Block else und gibt aus: "Es existiert kein Student mit der ID 2 im Wörterbuch."

TryGetValue optimiert Ihren Code, indem die Prüfung auf Existenz eines Schlüssels und der Abruf von Werten in einem einzigen Schritt kombiniert werden. Darüber hinaus bietet es eine Leistungssteigerung, insbesondere bei größeren Wörterbüchern, da mehrere Schlüsselabfragen überflüssig werden.

Einführung in Iron Suite

Während Sie Ihre Reise in C# fortsetzen, werden Sie viele Tools und Bibliotheken zur Verfügung haben, die Ihre Programmierfähigkeiten erheblich verbessern können. Unter diesen befinden sich die Iron Bibliotheken, eine Suite von Tools, die speziell entwickelt wurden, um die Funktionalität von C#-Anwendungen zu erweitern. Sie umfassen IronPDF, IronXL, IronOCR und IronBarcode. Jede dieser Bibliotheken hat einen einzigartigen Satz von Funktionen und bietet erhebliche Vorteile, wenn sie in Verbindung mit dem Standard-C# verwendet wird.

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

Abschluss

Nachdem wir die Funktionalitäten der Iron-Bibliotheken in Verbindung mit Standard-C#-Funktionen wie der TryGetValue-Methode untersucht haben, wird deutlich, dass diese Tools Ihren Entwicklungsprozess erheblich verbessern können. Ob Sie mit PDFs, Excels, OCRs oder Barcodes arbeiten, die Iron Suite hat eine Lösung, die auf Ihre Bedürfnisse zugeschnitten ist.

Besonders verlockend ist, dass jedes dieser Produkte eine kostenlose Testversion von Iron Software Products bietet, mit der Sie die Funktionen unverbindlich erkunden und ausprobieren können. Wenn Sie sich entscheiden, die Bibliotheken weiterhin zu nutzen, beginnt die Lizenz für jedes Produkt bei $999. Es liegt jedoch noch mehr Wert darin, wenn Sie an mehreren Iron-Bibliotheken interessiert sind, da Sie die vollständige Iron Suite zum Preis von nur zwei einzelnen Produkten erwerben können.