C# Dictionary Trygetvalue (How it Works for Developers)

瞭解 C# 辭典的基礎知識

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

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

詞典中的鍵是唯一的。 您可以存取鍵來取得相對應的值，這使得 Dictionaries 在查詢功能上有難以置信的效率。

傳統方法：ContainsKey 方法

在使用 C# 字典時，常見的任務是取得與特定鍵相關的值。 然而，直接存取不存在的鍵可能會產生 KeyNotFoundException，中斷您的程式流程。 為了避免這種情況，通常的做法是檢查字典中是否存在指定的關鍵字。 這就是 ContainsKey 方法發揮作用的地方。

ContainsKey 方法是一個直接且直覺的函式，可檢查 Dictionary 中是否存在特定的關鍵字。 以下是 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 is 20 years old"。如果您嘗試取得 Dictionary 中不存在的學生年齡，ContainsKey 方法將防止產生 KeyNotFoundException 並取代列印學生不存在的訊息。

然而，雖然 ContainsKey 方法很有用，但它並不總是最有效率的方法，因為要對 Dictionary 執行兩個查詢作業：一個用於 ContainsKey 方法，另一個用於擷取值。 這可能很花時間，尤其是在處理大型字典時。

雖然 ContainsKey 方法是一種簡單直觀的方式，可以在 Dictionary 中找不到指定的 key 時處理異常，但值得考慮其他方法，例如 TryGetValue 方法，它可以以更好的效能達到類似功能。 我們將在以下章節中詳細討論 TryGetValue 。

使用 TryGetValue 來結合驗證與擷取

這就是 TryGetValue 方法派上用場的地方。 TryGetValue 方法將驗證和值擷取結合在單一步驟中，提供幾乎相同的程式碼功能，但效能更強。

TryGetValue 方法需要兩個參數：

1.您正在尋找的關鍵 2.一個 out 參數，如果關鍵存在，該參數將持有值。

以下是語法：

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

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

out 關鍵字用於表示此方法將變更 value 參數。 如果找不到指定的 key，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 方法檢查關鍵 (student 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 library 是一套專門用來擴充 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");
    }
}

結論

當我們結合標準 C# 功能 (例如 TryGetValue 方法) 探索 Iron 函式庫的功能時，很明顯這些工具可以大幅提升您的開發流程。 無論您是處理 PDF、Excel 檔案、OCR 或 BarCode，Iron Suite 都有為您量身打造的解決方案。

更吸引人的是，每一個產品都提供 免費試用 Iron Software 產品，讓您可以免費探索和實驗功能。如果您決定繼續使用這些函式庫，每項產品的授權起點為 $799 。 不過，如果您對多個 Iron 函式庫感興趣，還可以發現更多價值，因為您只需花兩個單獨產品的價格，就可以購買完整的 Iron Suite。