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

Grundlagen des C#-Wörterbuchs verstehen

Bevor wir 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 das direkte Zugreifen auf einen nicht vorhandenen Schlüssel eine KeyNotFoundException auslösen, was den Ablauf Ihres Programms 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, gibt er true zurück; wenn nicht, gibt er false zurück.

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 eines Schülers namens "Alice" erfahren 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 is 20 years old" drucken. Wenn Sie versuchen würden, das Alter eines nicht im Dictionary vorhandenen Schülers zu erhalten, würde die ContainsKey-Methode verhindern, dass eine KeyNotFoundException ausgelöst wird, und stattdessen eine Nachricht drucken, dass der Schüler nicht existiert.

Obwohl die ContainsKey-Methode nützlich sein kann, ist sie nicht immer die effizienteste, da zwei Lookup-Operationen im Dictionary durchgeführt werden: eine für die ContainsKey-Methode und eine für das Abrufen des Werts. Dies kann zeitaufwendig sein, insbesondere wenn man mit großen Dictionaries arbeitet.

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

Kombinieren von Überprüfung und Abruf mit TryGetValue

Hier kommt die TryGetValue-Methode ins Spiel. Die TryGetValue-Methode kombiniert die Verifizierung und den Abruf des Werts in einem einzigen Schritt, bietet 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 anzugeben, 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.

So verwendet man TryGetValue:

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 zum ContainsKey-Methode-Beispiel, ist jedoch effizienter, da der Schlüssel nur einmal nachgeschlagen wird.

TryGetValue In Action Code Beispiel

Um die TryGetValue-Methode besser zu verstehen, lassen Sie uns ein praktisches Codebeispiel betrachten. 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önnte man zuerst die ContainsKey-Methode verwenden, um zu überprüfen, ob der Schlüssel (Schüler-ID 2) existiert und dann auf das Dictionary zugreifen, um den entsprechenden Wert (Schülername) zu erhalten. Mit der TryGetValue-Methode kann man dies jedoch in einem einzigen Schritt erreichen.

Die TryGetValue-Methode nimmt zwei Argumente auf: den gesuchten Schlüssel und einen out-Parameter, der den mit diesem Schlüssel verbundenen Wert enthält, 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 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 TryGetValue-Methode nach dem Schlüssel 2 im studentNames-Dictionary. Wenn sie den Schlüssel findet, weist sie den entsprechenden Wert der value-Variablen (dem Schülernamen) zu, und die Methode gibt true zurück. Dann druckt das Programm: "Der Name des Schülers mit ID 2 ist Bob."

Falls die TryGetValue-Methode den Schlüssel 2 nicht findet, weist sie den Standardwert für einen String (was null ist) der value-Variablen zu, und die Methode gibt false zurück. Der Code wechselt dann in den else-Block und druckt: "Kein Schüler mit ID 2 existiert im Dictionary."

TryGetValue vereinfacht Ihren Code, indem es die Schlüssel-Existenzprüfung und den Wertabruf in einem einzigen Schritt kombiniert. Zudem bietet es einen Leistungsgewinn, insbesondere bei größeren Dictionaries, da die Notwendigkeit für mehrere Schlüssel-Lookup-Operationen entfällt.

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

Wie wir die Funktionalitäten der Iron-Bibliotheken in Verbindung mit Standard-C#-Funktionen wie der TryGetValue-Methode untersucht haben, wird 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 der Iron Software-Produkte bietet, was Ihnen die Möglichkeit gibt, die Funktionen kostenlos zu erkunden und zu experimentieren. Wenn Sie sich entscheiden, die Bibliotheken weiterhin zu nutzen, beginnt die Lizenz ab $799 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.