C# 字典 Trygetvalue（開發者的工作原理）

了解 C# 字典的基礎知識

在深入了解 TryGetValue 方法之前，了解 C# 中的字典是什麼至關重要。 簡單來說，字典就是鍵/值對的集合。 例如，你可能有一個字典，其中鍵是學生的姓名（字串值），值是他們對應的年齡（整數值）。

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

字典中的鍵是唯一的。 你可以透過存取鍵來取得對應的值，這使得字典在尋找功能方面非常有效率。

傳統方法：ContainsKey 方法

在使用 C# 字典時，一個常見的任務是取得與特定鍵關聯的值。 但是，直接存取不存在的鍵可能會拋出 KeyNotFoundException 錯誤，從而中斷程式的執行流程。 為避免這種情況，通常的做法是檢查指定的鍵是否存在於字典中。 這時就需要用到 ContainsKey 方法了。

ContainsKey 方法是一個簡單直觀的函數，用於檢查字典中是否存在某個鍵。 以下是 ContainsKey 方法的基本語法：

Dictionary<TKey, TValue>.ContainsKey(TKey key)

Dictionary<TKey, TValue>.ContainsKey(TKey key)

它接受一個鍵作為參數，並傳回一個布林值。 如果鍵在字典中，則傳回 true； 否則，它將返回 false。

考慮以下範例，其中我們有一個字典，以學生姓名作為鍵，以他們對應的年齡作為值。

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

現在，如果你想取得名為"Alice"的學生的年齡，你首先需要使用 ContainsKey 方法檢查"Alice"是否是字典中的一個鍵。

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

在這種情況下，程式將列印"Alice 20 歲"。如果您嘗試取得字典中不存在的學生的年齡，ContainsKey 方法將防止拋出 KeyNotFoundException 異常，而是列印一條訊息，說明該學生不存在。

然而，雖然 ContainsKey 方法可能很有用，但它並不總是最有效的，因為對字典執行了兩次查找操作：一次用於 ContainsKey 方法，一次用於檢索值。 這可能會很耗時，尤其是在處理大型字典時。

雖然 ContainsKey 方法是一種簡單直觀的方法來處理在字典中找不到指定鍵時出現的異常，但值得考慮其他方法，例如 TryGetValue，這些方法可以實現類似的功能，並且性能更好。 我們將在以下章節中更詳細地討論 TryGetValue。

結合驗證和檢索 TryGetValue

這時 TryGetValue 方法就派上用場了。 TryGetValue 方法將驗證和值檢索合併為一個步驟，提供幾乎相同的程式碼功能，但效能更優。

TryGetValue 方法需要兩個參數：

1. 你要找的鑰匙。
2. 一個輸出參數，如果鍵存在，則儲存該值。

文法如下：

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

out 關鍵字用於表示此方法將更改 value 參數。 如果找不到指定的鍵，則 out 值將是值類型的預設值(整數為 0，引用類型為 null)。 否則，它將保存與提供的鍵對應的值。

以下是如何使用 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.");
}

這段程式碼提供的功能與 ContainsKey 方法範例幾乎相同，但它的效率更高，因為它只尋找一次鍵。

TryGetValue 操作程式碼範例

為了更好地理解 TryGetValue 方法，讓我們來探討一個實際的程式碼範例。 假設有一個學校資料庫，其中每個學生都有一個唯一的ID和對應的姓名。 資料儲存在字典中，以學生 ID 為鍵，姓名為值。

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

在這種情況下，假設你想檢索 ID 為 2 的學生的姓名，但你也想確保資料庫中存在具有此 ID 的學生。

傳統上，您可以先使用 ContainsKey 方法檢查鍵(學生 ID 2)是否存在，然後存取字典以取得相應的值(學生姓名)。 但是，使用 TryGetValue 方法，您可以一步完成此操作。

TryGetValue 方法接受兩個參數：你要尋找的鍵和一個 out 參數，該參數將保存與該鍵關聯的值(如果存在)。 如果找到金鑰，則該方法將傳回 true，並將對應的值賦給 out 參數。 否則，它將傳回 false，並且 out 參數將採用其類型的預設值。

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

在這種情況下，TryGetValue 方法在 studentNames 字典中尋找鍵 2。 如果找到金鑰，則將相應的值賦給 value 變數(學生姓名)，並且該方法傳回 true。 然後，程式列印出："ID 為 2 的學生姓名是 Bob。"

如果 TryGetValue 方法找不到鍵 2，它會將字串的預設值(即 null)賦值給 value 變量，並且該方法將傳回 false。 然後程式碼執行到 else 程式碼區塊，並列印出"字典中不存在 ID 為 2 的學生"。

TryGetValue 將鍵存在性檢查和值檢索合併為一個步驟，簡化了您的程式碼。此外，它還提高了效能，尤其是在處理大型字典時，因為它消除了多次鍵查找操作的需求。

隆重介紹Iron Suite

隨著您在 C# 學習之旅中不斷進步，您會發現許多工具和函式庫可供您使用，它們可以顯著增強您的程式設計能力。 其中包括 Iron 庫，這是一套專門用於擴展 C# 應用程式功能的工具。 其中包括IronPDF、 IronXL、 IronOCR和IronBarcode。 這些庫各具特色，與標準 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");
    }
}

結論

當我們探索 Iron 庫的功能以及標準 C# 功能(例如 TryGetValue 方法)時，很明顯，這些工具可以顯著增強您的開發過程。 無論您是處理 PDF 檔案、Excel 檔案、OCR 或條碼， Iron Suite都能提供滿足您需求的解決方案。

更吸引人的是，這些產品均提供Iron Software Products 的免費試用版，讓您可以免費探索和體驗各項功能。如果您決定繼續使用這些庫，則每個產品的許可證價格從 $799 起。 但是，如果您對多個 Iron 音色庫感興趣，您會發現更多價值，因為您可以用兩個單獨產品的價格購買完整的Iron Suite。