C# 字典 Trygetvalue（开发者如何使用）

理解 C# Dictionary 的基础

在深入了解 TryGetValue 方法之前，了解 C# 中的字典是什么至关重要。 简单来说，Dictionary 是一个键/值对的集合。 例如，您可能有一个 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}
};

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}

Dictionary 中的键是唯一的。 您可以访问键以获取相应的值，这使得 Dictionary 在查找功能上非常高效。

传统方法：ContainsKey 方法

在处理 C# Dictionary 时，一个常见的任务是获取与特定键关联的值。 但是，直接访问不存在的键可能会抛出 KeyNotFoundException 错误，从而中断程序的流程。 为了避免这种情况，通常的做法是在 Dictionary 中检查指定的键是否存在。 这时就需要用到 ContainsKey 方法了。

ContainsKey 方法是一个简单直观的函数，用于检查字典中是否存在某个键。 以下是 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)

它将键作为参数并返回一个布尔值。 如果键在字典中，则返回 true; 否则，它将返回 false。

考虑以下示例，其中我们有一个以学生姓名为键，其对应年龄为值的 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}
};

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"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.");
}

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

在这种情况下，程序将打印"Alice 20 岁"。如果您尝试获取字典中不存在的学生的年龄，ContainsKey 方法将防止抛出 KeyNotFoundException 异常，而是打印一条消息，说明该学生不存在。

然而，虽然 ContainsKey 方法可能很有用，但它并不总是最有效的，因为对字典执行了两次查找操作：一次用于 ContainsKey 方法，一次用于检索值。 这可能会消耗时间，尤其是在处理大型 Dictionary 时。

虽然 ContainsKey 方法是一种简单直观的方法来处理在字典中找不到指定键时出现的异常，但值得考虑其他方法，例如 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)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'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.");
}

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

这段代码提供的功能与 ContainsKey 方法示例几乎相同，但它的效率更高，因为它只查找一次键。

TryGetValue 操作代码示例

为了更好地理解 TryGetValue 方法，让我们来看一个实际的代码示例。 考虑一个学校数据库，其中每个学生都有一个唯一的 ID 和相应的名字。 这些数据存储在一个以学生 ID 为键，名字为值的 Dictionary 中。

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

在这种情况下，假设您想检索 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.");
}

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

在这种情况下，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");
    }
}

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

结论

当我们探索 Iron 库的功能以及标准 C# 功能（例如 TryGetValue 方法）时，很明显，这些工具可以显著增强您的开发过程。 无论您是在处理 PDF、Excel 文件、OCR 还是条码，Iron Suite 都有针对您的需求量身定制的解决方案。

更吸引人的是，这些产品均提供Iron Software Products 的免费试用版，让您可以免费探索和体验各项功能。如果您决定继续使用这些库，则每个产品的许可证价格从 $799 起。 但是，如果您对多个 Iron 库感兴趣，还有更多的价值，因为您可以以两个单独产品的价格购买完整的 Iron Suite。