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

Dictionary のキーは固有です。 キーにアクセスして対応する値を取得できるため、Dictionary は検索機能に非常に効率的です。

従来のアプローチ：ContainsKey メソッド

C# Dictionary を使用するとき、特定のキーに関連付けられた値を取得することが一般的なタスクです。 ただし、存在しないキーに直接アクセスすると、KeyNotFoundException がスローされ、プログラムの流れが中断される可能性があります。 これを避けるために、指定されたキーが Dictionary 内に存在するかどうかを確認するのが一般的な方法です。 ここで、ContainsKey メソッドが役立ちます。

ContainsKey メソッドは、特定のキーが辞書内に存在するかどうかを確認する、簡単で直感的な関数です。 ContainsKey メソッドの基本的な構文は次のとおりです。

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

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

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

この場合、プログラムは"アリスは20歳です"と出力します。辞書に存在しない生徒の年齢を取得しようとすると、ContainsKey メソッドによって KeyNotFoundException エラーがスローされるのを防ぎ、代わりに生徒が存在しないというメッセージを出力します。

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

ContainsKey メソッドは、指定されたキーが辞書に見つからない場合に例外を処理するシンプルで直感的な方法ですが、同様の機能をより良いパフォーマンスで実現できる TryGetValue などの代替メソッドを検討する価値があります。 次のセクションでは、TryGetValue についてさらに詳しく説明します。

検証と検索をTryGetValueと組み合わせる

ここで、TryGetValue メソッドが役に立ちます。 TryGetValue メソッドは、検証と値の取得を 1 つのステップに組み合わせ、ほぼ同じコード機能を提供しながら、パフォーマンスを強化します。

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

1. 探しているキー。
2. キーが存在する場合に値を保持する out パラメータ。

構文は以下の通りです：

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 メソッドの例とほぼ同じ機能を提供しますが、キーを 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"}
};

この場合、ID 2 の学生の名前を取得したいが、この ID を持つ学生がデータベースに存在することを確認したいとします。

従来は、まず ContainsKey メソッドを使用してキー (学生 ID 2) が存在するかどうかを確認し、次に辞書にアクセスして対応する値 (学生名) を取得します。 ただし、TryGetValue メソッドを使用すると、これを 1 つのステップで実行できます。

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

この場合、TryGetValue メソッドは、studentNames 辞書でキー 2 を検索します。 キーが見つかった場合、対応する値を value 変数 (生徒の名前) に割り当て、メソッドは true を返します。 その後、プログラムは"ID 2 の学生の名前は Bob です。"と出力します。

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

TryGetValue は、キーの存在確認と値の取得を1つのステップに統合することでコードを効率化します。さらに、複数のキー検索操作が不要になるため、特に大規模な辞書ではパフォーマンスが向上します。

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

結論

TryGetValue メソッドなどの標準 C# 機能と組み合わせて Iron ライブラリの機能を調べてきた結果、これらのツールによって開発プロセスが大幅に強化されることは明らかです。 PDF、Excel ファイル、OCR またはバーコードのいずれを扱っている場合でも、Iron Suiteはお客様のニーズに合わせたソリューションを提供します。

さらに魅力的なのは、これらの各製品にIron Software製品の無料トライアルが用意されており、無料で機能を試してみることができることです。ライブラリを引き続きご利用になる場合は、各製品のライセンスは$799から始まります。 ただし、複数の Iron ライブラリに興味がある場合は、2 つの個別製品の価格で Iron Suite 全体を購入することで、さらに価値を見出すことができます。