1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. C# 字典 TryGetValue
.NET 帮助

C# 字典 TryGetValue（开发人员如何使用）

发布 2023年八月29日
分享:

C# 是一种功能强大的通用语言，可提供多种功能。其中包括 C# 词典。

了解 C# 词典的基础知识

在深入研究 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}
}
VB   C#

字典中的键是唯一的。您可以通过访问键值来获取相应的值，这使得字典的查找功能异常高效。

传统方法：ContainsKey方法

在使用 C# 字典时，常见的任务是获取与特定键相关的值。然而，直接访问不存在的键可能会抛出 "KeyNotFoundException"（键未找到异常），从而中断程序流程。为了避免这种情况，通常的做法是检查指定的键是否存在于字典中。这就是 ContainsKey 方法发挥作用的地方。

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

它以键为参数，并返回一个布尔值。如果键在字典中，则返回 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}
};
Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}
VB   C#

现在，如果要获取名为 "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
VB   C#

在这种情况下，程序将打印 "Alice 今年 20 岁"。如果试图获取 Dictionary 中不存在的学生年龄，ContainsKey 方法会阻止抛出 KeyNotFoundException 异常，并打印出该学生不存在的信息。

不过，虽然 ContainsKey 方法很有用，但它并不总是最有效的方法。在上面的代码片段中，对 Dictionary 执行了两次查找操作：一次用于 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)
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)
VB   C#

out 关键字用于表示此方法将更改参数 value。如果找不到指定的键，out 值将是值类型的默认值。 (整数为 0，引用类型为空).否则，它将保存与所提供键值相对应的值。

下面介绍如何使用 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
VB   C#

这段代码提供了与 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"}
};
Dim studentNames As New Dictionary(Of Integer, String) From {
	{1, "Alice"},
	{2, "Bob"},
	{3, "Charlie"}
}
VB   C#

在这种情况下，假设您要检索 ID 为 2 的学生姓名，但同时也要确保数据库中存在这个 ID 的学生。

传统上，您可能首先使用 ContainsKey 方法来检查键是否存在于数据库中。 (学生编号 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
VB   C#

在这种情况下，"TryGetValue "方法会在 "studentNames "字典中查找键 2。如果找到了键，就会把相应的值赋给 value 变量 (学生姓名)该方法返回 true。然后，程序会打印出 "ID 为 2 的学生姓名是 Bob"。

如果 TryGetValue 方法没有找到键 2，它将为字符串分配默认值 (为空) 变量，该方法将返回 false。然后代码进入 else 块，打印出 "字典中不存在 ID 为 2 的学生"。

TryGetValue` 将键存在性检查和值检索合并为一个步骤，从而简化了代码。此外，由于无需进行多次键查找操作，它还能提高性能，尤其是在字典较大的情况下。

钢铁套房介绍

随着您在 C# 的道路上不断前进，您会发现有许多工具和库可供您使用，它们可以大大提高您的编程能力。其中包括 Iron 库，这是一套专门用于扩展 C# 应用程序功能的工具。它们包括 IronPDF、IronXL、IronOCR 和 IronBarcode。每个库都有一套独特的功能，当与标准 C# 结合使用时，它们都能提供显著的优势。

IronPDF

C# 词典 `TryGetValue`（开发人员如何使用） 图 1

IronPDF 是一个 C# 库，旨在 从 HTML 创建 PDF 文件在 .NET 应用程序中编辑和提取 PDF 内容。使用 IronPDF，您可以以编程方式生成 PDF 报告、填写 PDF 表单和操作 PDF 文档。该库还提供 HTML 到 PDF 的转换功能，可轻松将现有的 HTML 内容转换为 PDF。

IronPDF 的亮点在于 HTML 转 PDF 功能，可保持所有布局和样式完好无损。它允许你从网页内容创建 PDF，适用于报告、发票和文档。HTML 文件、URL 和 HTML 字符串都可以无缝转换为 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");
    }
}
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
VB   C#

就我们的主题而言，想象一下从字典中获取学生数据并生成 PDF 报告的场景。TryGetValue "可以高效地获取必要的数据，然后利用 IronPDF 创建 PDF 文档。

IronXL

C# 词典 `TryGetValue`（开发人员如何使用） 图 2

IronXL 是一个用于 C# 和 .NET 的 Excel 库。它能让开发人员在.NET 应用程序中读取、写入和创建 Excel 文件，而无需 Interop。它非常适合需要从 Excel 电子表格中导出或导入数据的情况。

关于 TryGetValue，假设您有一个字典，其中键代表产品 ID，值代表产品数量。您可以使用 TryGetValue 来检索特定产品的数量，然后使用 IronXL 在 Excel 库存管理电子表格中更新该数量。

IronOCR

C# 词典 TryGetValue（开发人员如何使用） 图 3

IronOCR 是一种先进的 OCR (光学字符识别) 适用于 .NET 和 C# 的条形码读取库。它允许开发人员在 .NET 应用程序中读取图像和 PDF 中的文本和条形码。当您需要从扫描的文档或图像中提取数据并在代码中加以处理时，这一点尤其有用。

假设您使用 IronOCR 从扫描文档中提取学生 ID。处理完成后，您将 ID 和相应的学生详细信息存储在字典中。在检索某个学生的详细信息时，可以使用 TryGetValue 从字典中高效地获取数据。

IronBarcode

C# 词典 `TryGetValue`（开发人员如何使用） 图 4

IronBarcode 是一款适用于 .NET 的条形码读写库。通过 IronBarcode，开发人员可以生成和读取各种条形码和 QR 码格式。它是一款功能强大的工具，能以紧凑、机器可读的格式对数据进行编码和解码。

在实际应用中，想象一下在零售系统中使用条形码来存储产品信息。每个条形码都对应一个唯一的产品 ID，作为键存储在字典中。扫描条形码时，您可以使用 TryGetValue 快速从字典中获取并显示相关的产品详细信息。

结论

在我们结合标准 C# 功能（如 TryGetValue 方法）探索了 Iron 库的功能后，我们可以清楚地看到，这些工具可以显著增强您的开发流程。无论您是在处理 PDF、Excel 文件、OCR 还是条形码，Iron 库都能为您提供帮助。 铁套房 可根据您的需求量身定制解决方案。

更诱人的是，每种产品都能提供 免费试用，让您可以免费探索和尝试这些功能。如果您决定继续使用这些库，每个产品的许可证起价为 $749。不过，如果您对多个 Iron 库感兴趣，还可以发现更多价值，因为您只需以两个单个产品的价格即可购买完整的 Iron Suite。

< 前一页
C# 默认参数（开发人员工作原理）
下一步 >
C# 圆 (如何为开发人员工作)

报告问题

准备开始了吗？ 版本： 2024.9 刚刚发布

免费NuGet下载 总下载量: 10,731,156 查看许可证 >

获取您的免费

30天试用密钥 立即。

15天试用密钥 立即。

bullet_checked无需信用卡或创建账户
试用表格已提交
成功地。

您的试用密钥应在电子邮件中。
如果不是，请联系
support@ironsoftware.com

子弹测试测试生产环境
无水印
子弹日历30天全功能使用
功能性产品
子弹支持24/5技术支持
试用期间的支持

谢谢！

您的许可证密钥已发送到所提供的电子邮件。联系我们

24小时升级优惠：

Save 50% 在一个
专业 升级

去 专业 支持10位开发者
和无限项目。

小时

:

分钟

:

秒

升级到Professional

升级

专业

$600 美元

$299 美元

  • 10位开发者
  • 10个位置
  • 10个项目
今天 只有

5个.NET产品，两件的价格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

套件总价值：

$7,192 美元

升级价格

今天
只有

$499 美元

24小时后

$1,098 美元