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

Grundlagen des C#-Wörterbuchs verstehen

Bevor Sie sich in die TryGetValue Methode vertiefen, ist es entscheidend 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}
};

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. Wenn Sie jedoch direkt auf einen nicht vorhandenen Schlüssel zugreifen, kann eine KeyNotFoundException ausgelöst werden, die 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 unkomplizierte 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)

Sie nimmt den Schlüssel als Parameter und gibt einen Boolean-Wert zurück. Wenn der Schlüssel im Dictionary vorhanden ist, 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}
};

Wenn Sie nun das Alter einer Studentin namens "Alice" ermitteln möchten, würden Sie zuerst die ContainsKey Methode verwenden, um zu überprü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.");
}

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 geworfen wird, und stattdessen eine Nachricht ausgeben, dass der Student nicht existiert.

Während die ContainsKey Methode nützlich sein kann, ist sie nicht immer die effizienteste, da zwei Lookup-Operationen auf dem Dictionary ausgeführt werden: eine für die ContainsKey Methode und eine, 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, ist es wert, alternative Methoden wie TryGetValue in Betracht zu ziehen, die mit besserer Leistung eine ähnliche Funktionalität erreichen können. Wir werden TryGetValue im Detail in den folgenden Abschnitten besprechen.

Kombinieren von Überprüfung und Abruf mit TryGetValue

Hier wird die TryGetValue Methode nützlich. Die TryGetValue Methode kombiniert die Überprüfung und den Wertabruf in einem Schritt und bietet fast identische Codefunktionalität bei 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)

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 Ganzzahlen, null für Referenztypen). Andernfalls enthält er den Wert, der dem angegebenen Schlüssel entspricht.

Hier ist, wie man TryGetValue verwendet:

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.");
}

Dieser Code bietet fast identische Funktionalität zum ContainsKey Methode-Beispiel, ist aber effizienter, da er den Schlüssel nur einmal sucht.

TryGetValue Im Einsatz Codebeispiel

Um die TryGetValue Methode besser zu verstehen, betrachten wir ein praktisches Codebeispiel. 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"}
};

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 überprüfen, ob der Schlüssel (Studenten-ID 2) existiert, und dann auf das Dictionary zugreifen, um den entsprechenden Wert (Studentenname) zu erhalten. Mit der TryGetValue Methode können Sie dies jedoch in einem Schritt erreichen.

Die TryGetValue Methode nimmt zwei Argumente entgegen: den Schlüssel, den Sie suchen, und einen out Parameter, der den mit diesem Schlüssel verbundenen Wert enthält, falls er existiert. Wenn der Schlüssel gefunden wird, wird die Methode true zurückgeben und den entsprechenden Wert dem out Parameter zuweisen. Wenn nicht, wird sie false zurückgeben, und der out Parameter wird den Standardwert für seinen Typ annehmen.

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.");
}

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 (der Name 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, wird sie den Standardwert für einen String (der null ist) der value Variablen zuweisen, und die Methode wird false zurückgeben. Der Code geht dann in den else Block über und gibt "Kein Student mit ID 2 existiert im Dictionary." aus.

TryGetValue optimiert Ihren Code, indem die Überprüfung der Schlüsseldaseins und der Wertabruf in einem Schritt kombiniert wird. Darüber hinaus bietet es einen Leistungsschub, insbesondere bei größeren Dictionaries, da mehrfachen Schlüssel-Suchvorgänge entfallen.

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

Abschluss

Da wir die Funktionen der Iron-Bibliotheken in Verbindung mit Standard-C#-Merkmalen 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.

Noch verlockender ist, dass jedes dieser Produkte eine kostenlose Testversion von Iron Software-Produkten bietet, die es Ihnen ermöglicht, die Funktionen kostenlos zu erkunden und auszuprobieren. Wenn Sie sich entscheiden, die Bibliotheken weiter zu nutzen, beginnt die Lizenz bei $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.