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

Zrozumienie podstaw słownika C

Zanim zagłębimy się w metodę TryGetValue, trzeba zrozumieć, czym jest słownik w języku 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.

Podejście konwencjonalne: ContainsKey Metoda

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 spowodować wygenerowanie błędu 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 wkracza metoda ContainsKey.

Metoda ContainsKey jest prostą i intuicyjną funkcją, która sprawdza, czy dany klucz występuje w słowniku. 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 znajduje się w słowniku, zwróci true; w przeciwnym razie 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 uczennicy o imieniu "Alice", najpierw użyj metody ContainsKey, aby sprawdzić, czy "Alice" jest kluczem w słowniku.

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świetlałby komunikat "Alice ma 20 lat". Jeśli spróbowałbyś uzyskać wiek ucznia, którego nie ma w słowniku, metoda ContainsKey zapobiegłaby wygenerowaniu błędu KeyNotFoundException i zamiast tego PRINTowałaby komunikat, że uczeń nie istnieje.

Jednakże, chociaż metoda ContainsKey może być przydatna, nie zawsze jest najbardziej wydajna, ponieważ w słowniku wykonywane są dwie operacje wyszukiwania: jedna dla metody ContainsKey i jedna w celu 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 obsługi wyjątków w przypadku, gdy określony klucz nie zostanie znaleziony w słowniku, warto rozważyć alternatywne metody, takie jak TryGetValue, które pozwalają osiągnąć podobną funkcjonalność przy lepszej wydajności. W kolejnych sekcjach omówimy TryGetValue bardziej szczegółowo.

Łączenie weryfikacji i wyszukiwania z TryGetValue

W tym miejscu przydatna jest metoda TryGetValue. Metoda TryGetValue łączy weryfikację i pobieranie 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 oznacza, że ta metoda zmieni parametr value. Wartość out będzie wartością domyślną typu wartości, jeśli nie zostanie znaleziony określony klucz (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 praktyce

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 można by najpierw użyć metody ContainsKey, aby sprawdzić, czy klucz (identyfikator studenta 2) istnieje, a następnie uzyskać dostęp do słownika, aby pobrać odpowiednią wartość (imię i nazwisko studenta). Jednak dzięki metodzie TryGetValue można to osiągnąć w jednym kroku.

Metoda TryGetValue przyjmuje dwa argumenty: klucz, którego szukasz, oraz parametr out, który będzie zawierał wartość powiązaną z tym kluczem, jeśli istnieje. Jeśli klucz zostanie znaleziony, metoda zwróci true i przypisze odpowiednią wartość do parametru out. W przeciwnym razie zwróci false, a parametr out przyjmie wartość domyślną 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 wyszukuje klucz 2 w słowniku studentNames. Jeśli znajdzie klucz, przypisuje odpowiednią wartość do zmiennej value (imię i nazwisko ucznia), a metoda zwraca true. Następnie program wyświetla komunikat: "Imię ucznia o numerze identyfikacyjnym 2 to Bob".

Jeśli metoda TryGetValue nie znajdzie klucza 2, przypisze zmiennej value domyślną wartość dla ciągu znaków (czyli null), a metoda zwróci false. Kod trafia następnie do bloku else, wyświetlając komunikat: "W słowniku nie ma ucznia o identyfikatorze 2".

TryGetValue usprawnia kod, łącząc sprawdzanie istnienia klucza i pobieranie wartości w jednym kroku. Ponadto zapewnia wzrost wydajności, szczególnie w przypadku większych słowników, eliminując potrzebę wykonywania wielu operacji wyszukiwania kluczy.

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

Po zapoznaniu się z funkcjonalnością bibliotek Iron w połączeniu ze standardowymi funkcjami języka C#, takimi jak metoda TryGetValue, jasne jest, że narzędzia te mogą znacznie usprawnić proces programowania. 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, każdy z tych produktów oferuje bezpłatną wersję próbną produktów Iron Software, co pozwala na bezpłatne zapoznanie się z funkcjami i wypróbowanie ich. Jeśli zdecydujesz się na dalsze korzystanie z bibliotek, cena licencji zaczyna się od $799 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.