Caution
お使いのブラウザはJavaScriptが実行できない状態になっております。
当サイトはWebプログラミングの情報サイトの為、
JavaScriptが実行できない環境では正しいコンテンツが提供出来ません。
JavaScriptが実行可能な状態でご閲覧頂くようお願い申し上げます。
辞書.Add() / Remove() / Clear()
キーと値のペアを管理する『Dictionary<TKey, TValue>』に要素を追加する『Add()』、削除する『Remove()』、全消去する『Clear()』メソッドです。
構文
using System.Collections.Generic; // Dictionary を作成します。 Dictionary<TKey, TValue> 辞書 = new Dictionary<TKey, TValue>(); // キーと値のペアを追加します。キーが既に存在する場合は ArgumentException をスローします。 辞書.Add(TKey key, TValue value) // キーに対応する要素を削除します。削除できた場合は true を返します。 辞書.Remove(TKey key) // すべての要素を削除します。 辞書.Clear()
メソッド一覧
| メソッド | 概要 |
|---|---|
| Add(TKey key, TValue value) | 指定したキーと値のペアを追加します。キーが既に存在する場合は ArgumentException がスローされます。 |
| 辞書[key] = value | インデクサーでキーに値を設定します。キーが存在しない場合は追加、存在する場合は上書きします。 |
| Remove(TKey key) | 指定したキーとそれに対応する値を削除します。キーが存在すれば true、なければ false を返します。 |
| Clear() | Dictionary のすべての要素を削除します。Count が 0 になります。 |
サンプルコード
using System;
using System.Collections.Generic;
// Dictionary<string, int> を作成して要素を追加します。
Dictionary<string, int> 点数表 = new Dictionary<string, int>();
点数表.Add("田中", 85);
点数表.Add("佐藤", 92);
点数表.Add("鈴木", 78);
Console.WriteLine(点数表.Count); // 3
// インデクサーで値を取得・設定します。
Console.WriteLine(点数表["田中"]); // 85
// インデクサーで上書きします（Add() と違いキー重複でエラーになりません）。
点数表["田中"] = 90;
Console.WriteLine(点数表["田中"]); // 90
// 初期値付きで作成する方法です。
Dictionary<string, string> 首都 = new Dictionary<string, string>
{
{ "日本", "東京" },
{ "アメリカ", "ワシントンD.C." },
{ "フランス", "パリ" }
};
// Remove() で要素を削除します。
bool 削除結果 = 首都.Remove("フランス");
Console.WriteLine(削除結果); // True
Console.WriteLine(首都.Count); // 2
// Clear() ですべて削除します。
点数表.Clear();
Console.WriteLine(点数表.Count); // 0
概要
辞書のキーは重複できません。同じキーで『Add()』を2回呼び出すと ArgumentException がスローされます。キーが既に存在するかどうか不明な場合は、インデクサー 辞書[key] = value を使うか、事前に『ContainsKey()』で確認してください。
インデクサーで存在しないキーを取得しようとすると KeyNotFoundException がスローされます。安全に値を取得するには『TryGetValue()』を使用してください。
記事の間違いや著作権の侵害等ございましたらお手数ですがこちらまでご連絡頂ければ幸いです。
シェアする