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

Die Grundlagen des C#-Wörterbuchs verstehen

Bevor Sie in die TryGetValue Methode eintauchen, 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. Allerdings kann der direkte Zugriff auf einen nicht existierenden Schlüssel eine KeyNotFoundException auslösen, die den Programmablauf unterbricht. Um dies zu vermeiden, ist es gängige Praxis zu überprüfen, ob der angegebene Schlüssel im Dictionary vorhanden ist. Hier kommt die ContainsKey Methode ins Spiel.

Die ContainsKey Methode ist eine einfache und intuitive Funktion, die überprüft, ob ein bestimmter Schlüssel im Dictionary 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 sich der Schlüssel im Dictionary befindet, wird true zurückgegeben; wenn nicht, 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 Studentin namens "Alice" herausfinden möchten, würden Sie zuerst die ContainsKey Methode verwenden, um zu prüfen, ob "Alice" ein Schlüssel im Dictionary 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 wird das Programm "Alice ist 20 Jahre alt." ausgeben. Wenn Sie versuchen würden, das Alter eines nicht im Dictionary vorhandenen Studenten zu ermitteln, würde die ContainsKey Methode verhindern, dass eine KeyNotFoundException ausgelöst wird, und stattdessen eine Nachricht ausgeben, dass der Student nicht existiert.

Obwohl die ContainsKey Methode nützlich sein kann, ist sie nicht immer die effizienteste, da zwei Suchvorgänge im Dictionary durchgeführt werden: einer für die ContainsKey Methode und einer, um den Wert abzurufen. Dies kann zeitaufwendig sein, insbesondere wenn man mit großen Dictionaries arbeitet.

Obwohl die ContainsKey Methode eine einfache und intuitive Möglichkeit ist, Ausnahmen zu behandeln, wenn ein bestimmter Schlüssel in einem Dictionary nicht gefunden wird, sollte man alternative Methoden wie TryGetValue in Betracht ziehen, die ähnliche Funktionalität mit besserer Leistung bieten können. Wir werden TryGetValue im Detail in den folgenden Abschnitten besprechen.

Verifizierung und Abruf kombinieren mit TryGetValue

Hier erweist sich die TryGetValue Methode als nützlich. Die TryGetValue Methode kombiniert die Verifizierung und den Werteabruf in einem einzigen Schritt und bietet eine nahezu identische Code-Funktionalität, jedoch mit verbesserter Leistung.

Die TryGetValue Methode erfordert 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 out Schlüsselwort wird verwendet, um anzuzeigen, dass diese Methode den value Parameter ändern wird. Der out Wert wird der Standardwert des Werttyps sein, wenn der angegebene Schlüssel nicht gefunden wird (0 für Integer, null für Referenztypen). Andernfalls enthält er den Wert, der dem angegebenen Schlüssel entspricht.

Hier ist, 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 nahezu identische Funktionalität wie das Beispiel der ContainsKey Methode, ist jedoch effizienter, da er den Schlüssel nur einmal nachschlägt.

TryGetValue im Aktion Codebeispiel

Um die TryGetValue Methode besser zu verstehen, lassen Sie uns ein praktisches Codebeispiel erkunden. 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 könnten Sie zuerst die ContainsKey Methode verwenden, um zu prüfen, ob der Schlüssel (Studenten-ID 2) existiert, und dann auf das Dictionary zugreifen, um den entsprechenden Wert (Studentenname) abzurufen. Mit der TryGetValue Methode können Sie dies jedoch in einem einzigen Schritt erreichen.

Die TryGetValue Methode benötigt zwei Argumente: den Schlüssel, den Sie suchen, und einen out Parameter, der den Wert enthält, der mit diesem Schlüssel verbunden ist, wenn er existiert. Wenn der Schlüssel gefunden wird, gibt die Methode true zurück und weist den entsprechenden Wert dem out Parameter zu. Wenn nicht, gibt sie false zurück, und der out Parameter nimmt den Standardwert seines Typs 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 TryGetValue Methode nach dem Schlüssel 2 im studentNames Dictionary. Wenn sie den Schlüssel findet, weist sie den entsprechenden Wert der value Variablen zu (dem Namen des Studenten), und die Methode gibt true zurück. Dann druckt das Programm: "Der Name des Schülers mit ID 2 ist Bob."

Wenn die TryGetValue Methode den Schlüssel 2 nicht findet, weist sie den Standardwert für eine Zeichenfolge (was null ist) der value Variablen zu, und die Methode gibt false zurück. Der Code durchläuft dann den else Block und gibt aus: "Kein Student mit der ID 2 existiert im Dictionary."

TryGetValue optimiert Ihren Code, indem es die Überprüfung des Schlüssels und den Werteabruf in einem einzigen Schritt kombiniert. Darüber hinaus bietet es einen Leistungsgewinn, insbesondere bei größeren Dictionaries, da es nicht notwendig ist, mehrere Schlüsselüberprüfungsoperationen durchzuführen.

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

Während wir die Funktionalitäten der Iron-Bibliotheken in Verbindung mit standardmäßigen C#-Funktionen wie der TryGetValue Methode erkundet haben, ist klar, 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.

Was noch verlockender ist, ist, dass jedes dieser Produkte eine kostenlose Testversion von Iron Software-Produkten bietet, sodass Sie die Funktionen kostenlos erkunden und experimentieren können. Wenn Sie sich entscheiden, die Bibliotheken weiterhin zu nutzen, beginnt die Lizenz bei $999 für jedes Produkt. 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.