Słownik C# Trygetvalue (jak to działa dla programistów)

Zrozumienie podstaw słownika C

Przed zanurzeniem się w metodę TryGetValue, ważne jest zrozumienie, czym jest Dictionary w C#. Mówiąc prościej, słownik to zbiór par klucz-wartość. Na przykład możesz mieć słownik, w którym klucze to imiona uczniów (wartości typu string), a wartości to odpowiadające im wieki (wartości typu integer).

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

Klucze w słowniku są unikalne. Możesz uzyskać dostęp do kluczy, aby pobrać odpowiednią wartość, co sprawia, że słowniki są niezwykle wydajne w funkcji wyszukiwania.

Tradycyjne podejście: metoda ContainsKey

Podczas pracy ze słownikami C# częstym zadaniem jest pobranie wartości powiązanej z konkretnym kluczem. Jednak bezpośredni dostęp do klucza, który nie istnieje, może wywołać KeyNotFoundException, przerywając działanie programu. Aby tego uniknąć, powszechną praktyką jest sprawdzenie, czy określony klucz istnieje w słowniku. W tym miejscu do gry wchodzi metoda ContainsKey.

Metoda ContainsKey to prosta i intuicyjna funkcja, która sprawdza, czy określony klucz jest obecny w Dictionary. Oto podstawowa składnia metody ContainsKey:

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)

Przyjmuje klucz jako parametr i zwraca wartość logiczną. Jeśli klucz jest w Dictionary, zwróci true; jeśli nie, zwróci false.

Rozważmy następujący przykład, w którym mamy słownik z nazwiskami uczniów jako kluczami i odpowiadającymi im wiekami jako wartościami.

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

Jeśli chcesz uzyskać wiek ucznia o imieniu "Alice", najpierw użyjesz metody ContainsKey, aby sprawdzić, czy "Alice" jest kluczem w 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.");
}

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

W tym przypadku program wyświetli "Alice ma 20 lat". Jeśli próbowałbyś uzyskać wiek ucznia nieobecnego w Dictionary, metoda ContainsKey zapobiegnie rzuceniu KeyNotFoundException i zamiast tego wyświetli wiadomość, że uczeń nie istnieje.

Jednakże, chociaż metoda ContainsKey może być użyteczna, nie zawsze jest najbardziej wydajna, ponieważ przeprowadzane są dwie operacje wyszukiwania w Dictionary: jedna dla metody ContainsKey i jedna do pobrania wartości. Może to być czasochłonne, zwłaszcza w przypadku dużych słowników.

Chociaż metoda ContainsKey jest prostym i intuicyjnym sposobem radzenia sobie z wyjątkami, gdy określonego klucza nie znaleziono w Dictionary, warto rozważyć alternatywne metody, takie jak TryGetValue, które mogą osiągnąć podobną funkcjonalność z lepszą wydajnością. Omówimy TryGetValue bardziej szczegółowo w kolejnych sekcjach.

Łączenie weryfikacji i pobierania za pomocą TryGetValue

W tym miejscu przydatna staje się metoda TryGetValue. Metoda TryGetValue łączy weryfikację z pobieraniem wartości w jednym kroku, oferując niemal identyczną funkcjonalność kodu, ale z lepszą wydajnością.

Metoda TryGetValue wymaga dwóch parametrów:

1. Klucz, którego szukasz.
2. Parametr wyjściowy, który będzie przechowywał wartość, jeśli klucz istnieje.

Oto składnia:

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)

Słowo kluczowe out jest używane, aby oznaczyć, że ta metoda zmieni parametr value. Wartość out będzie domyślną wartością typu wartościowego, jeśli określonego klucza nie odnaleziono (0 dla liczb całkowitych, null dla typów referencyjnych). W przeciwnym razie będzie zawierać wartość odpowiadającą podanemu kluczowi.

Oto jak używać 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

Ten kod zapewnia niemal identyczną funkcjonalność jak przykład metody ContainsKey, ale jest bardziej wydajny, ponieważ wyszukuje klucz tylko raz.

TryGetValue Przykład kodu w akcji

Aby lepiej zrozumieć metodę TryGetValue, przyjrzyjmy się praktycznemu przykładowi kodu. Weźmy pod uwagę szkolną bazę danych, w której każdy uczeń ma unikalny identyfikator i odpowiadające mu imię. Dane te są przechowywane w słowniku, w którym identyfikator studenta stanowi klucz, a nazwa – wartość.

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

W tym przypadku załóżmy, że chcesz pobrać imię i nazwisko ucznia o identyfikatorze 2, ale chcesz również upewnić się, że uczeń o tym identyfikatorze istnieje w bazie danych.

Tradycyjnie najpierw użyjesz metody ContainsKey, aby sprawdzić, czy klucz (ID ucznia 2) istnieje, a następnie uzyskasz dostęp do Dictionary, aby uzyskać odpowiadającą mu wartość (imie ucznia). Jednak dzięki metodzie TryGetValue możesz to zrobić w jednym kroku.

Metoda TryGetValue przyjmuje dwa argumenty: klucz, którego szukasz, i parametr out, który będzie przechowywał wartość związaną z tym kluczem, jeśli istnieje. Jeśli klucz zostanie znaleziony, metoda zwróci true i przypisze odpowiadającą wartość do parametru out. Jeśli nie, zwróci false, a parametr out przyjmie domyślną wartość dla swojego typu.

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

W tym przypadku metoda TryGetValue szuka klucza 2 w Dictionary studentNames. Jeśli znajdzie klucz, przypisuje odpowiadającą wartość do zmiennej value (imie ucznia), a metoda zwraca true. Następnie program PRINTuje komunikat: "Imię ucznia o numerze identyfikacyjnym 2 to Bob".

Jeśli metoda TryGetValue nie znajdzie klucza 2, przypisze domyślną wartość dla string (która jest null) do zmiennej value, a metoda zwróci false. Kod następnie przechodzi do bloku else, wyświetlając "Nie ma ucznia o ID 2 w słowniku".

TryGetValue upraszcza twój kod, łącząc sprawdzanie obecności klucza z pobieraniem wartości w jednym kroku. Co więcej, zapewnia większą wydajność, szczególnie w przypadku większych słowników, eliminując potrzebę wielokrotnych operacji wyszukiwania klucza.

Przedstawiamy Iron Suite

W miarę postępów w nauce języka C# odkryjesz wiele narzędzi i bibliotek, które mogą znacznie zwiększyć Twoje możliwości programistyczne. Wśród nich znajdują się biblioteki Iron, zestaw narzędzi zaprojektowanych specjalnie w celu rozszerzenia funkcjonalności aplikacji C#. Należą do nich IronPDF, IronXL, IronOCR i IronBarcode. Każda z tych bibliotek ma unikalny zestaw funkcji i wszystkie zapewniają znaczące korzyści w połączeniu ze standardowym językiem C#.

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

Wnioski

Jak zgłębiliśmy funkcjonalności bibliotek Iron w połączeniu z standardowymi funkcjami C#, takimi jak metoda TryGetValue, jest oczywiste, że te narzędzia mogą znacznie poprawić proces tworzenia aplikacji. Niezależnie od tego, czy pracujesz z plikami PDF, Excel, OCR czy BarCodes, pakiet Iron Suite oferuje rozwiązanie dostosowane do Twoich potrzeb.

Co więcej interesujące jest to, że każdy z tych produktów oferuje bezpłatną wersję próbna produktów Iron Software, umożliwiając eksplorację i eksperymentację z funkcjami bez kosztów. Jeśli zdecydujesz się na dalsze korzystanie z bibliotek, licencja zaczyna się od $999 za każdy produkt. Jeśli jednak interesuje Cię więcej bibliotek Iron, możesz zyskać jeszcze więcej, ponieważ pełna Iron Suite można kupić w cenie zaledwie dwóch pojedynczych produktów.