C# Dictionary Trygetvalue (開発者向けの仕組み)

C# Dictionary の基本を理解する

TryGetValue メソッドに入る前に、C# での Dictionary とは何かを理解することが重要です。 簡単に言えば、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 メソッドは、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)

キーをパラメータとして受け取り、ブール値を返します。 キーが Dictionary に存在する場合、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」が 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.");
}

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 歳です。」と表示します。Dictionary に存在しない学生の年齢を取得しようとすると、ContainsKey メソッドは KeyNotFoundException の発生を防ぎ、代わりに学生が存在しないというメッセージを表示します。

しかし、ContainsKey メソッドは便利ですが、必ずしも最も効率的ではありません。なぜなら、Dictionary に対して 2 つの検索操作を行うためです：1 つは ContainsKey メソッド、もう 1 つは値を取得するためです。 特に大規模な Dictionary を扱う際には、これは時間がかかる可能性があります。

指定したキーが Dictionary に存在しない場合の例外を処理するためのシンプルで直感的な方法として ContainsKey メソッドは役に立ちますが、TryGetValue のような効率の良い代替手段を考慮する価値があります。 次のセクションで TryGetValue について詳しく説明します。

TryGetValue を使った検証と取得の統合

ここで TryGetValue メソッドが役立ちます。 TryGetValue メソッドは、検証と値の取得を一度に行うステップを提供し、性能が向上しつつほぼ同一のコード機能を提供します。

TryGetValue メソッドには 2 つのパラメータが必要です：

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 メソッドの例とほぼ同一の機能を提供しますが、キーを 1 回だけ検索するため、より効率的です。

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）が存在するかを確認し、次に Dictionary にアクセスして対応する値（学生の名前）を取得することがあります。 TryGetValue メソッドを使用すると、これを一度で達成できます。

TryGetValue メソッドは、探しているキーと、存在する場合にそのキーに関連付けられた値を保持する out パラメータの 2 つの引数を取ります。 キーが見つかった場合、メソッドは 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 Dictionary でキー 2 を探します。 キーが見つかった場合、その対応する値を value 変数（学生の名前）に割り当て、メソッドは true を返します。 その後、プログラムは「ID 2 の学生の名前は Bob です。」と出力します。

TryGetValue メソッドがキー 2 を見つけられない場合、文字列のデフォルト値（null）を value 変数に割り当て、メソッドは false を返します。 コードは次に else ブロックに進み、「ID 2 の学生は Dictionary に存在しません。」と出力します。

TryGetValueによって、キーの存在確認と値の取得を一度に行うことでコードが簡素化されます。特に大規模な Dictionary では、複数のキー検索操作を排除することでパフォーマンスが向上します。

Iron Suite の紹介

C# の旅を進める中で、プログラムの能力を大幅に強化するさまざまなツールとライブラリが手に入ります。 その中には、C# アプリケーションの機能を拡張するために特別に設計された Iron ライブラリがあります。 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 製品の無料トライアルを提供していることです。ライブラリを使用継続することを決定した場合、ライセンスは各製品ごとに $799 から開始します。 ただし、複数の Iron ライブラリに興味がある場合は、2 つの個別製品の価格で Iron Suite 全体を購入することで、さらに価値を見出すことができます。