Dictionary.Item プロパティとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > Dictionary.Item プロパティの意味・解説 

Dictionary.Item プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

指定したキーに関連付けられている値を取得または設定します。

名前空間: System.Collections.Generic
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Public Default Property
 Item ( _
    key As TKey _
) As TValue
Dim instance As Dictionary(Of
 TKey, TValue)
Dim key As TKey
Dim value As TValue

value = instance(key)

instance(key) = value
public TValue this [
    TKey key
] { get; set; }
public:
virtual property TValue default [TKey] {
    TValue get (TKey key) sealed;
    void set (TKey key, TValue value) sealed;
}
/** @property */
public final TValue get_Item (TKey key)

/** @property */
public final void set_Item (TKey key, TValue
 value)

パラメータ

key

取得または設定する値のキー。

プロパティ値
指定したキーに関連付けられている値。指定したキーが見つからなかった場合、取得操作は KeyNotFoundException をスローし、設定操作は指定したキーを持つ新しい要素を作成します。

例外例外
例外の種類条件

ArgumentNullException

key が null 参照 (Visual Basic では Nothing) です。

KeyNotFoundException

プロパティが取得されましたが、コレクション内に key が存在しません。

解説解説

このプロパティを使用すると、C# の myCollection[key] (Visual Basic では myCollection(key)) という構文を使用して、コレクション内の特定の要素にアクセスできます。

Item プロパティを使用すると、Dictionary 内に存在しないキーの値を設定することで、新しい要素を追加することもできます (例 : myCollection["myNonexistentKey"] = myValue)。ただし、指定したキーが Dictionary 内に既に存在する場合、Item プロパティを設定すると既存の値が上書きされます。対照的に、Add メソッドは既存の要素を変更しません。

キーを null 参照 (Visual Basic では Nothing) にすることはできませんが、値の型 TValue が参照型である場合、値を null にすることはできます。

このプロパティ値を取得または設定することは、O(1) 操作に近くなります。

使用例使用例

次のコード例では、Item プロパティ (C# ではインデクサ) を使用して値を取得し、要求されたキーが存在しないときに KeyNotFoundException がスローされる例を示し、またキーに関連付けられた値が置き換えられることも示します。

また、この例では、プログラムがディクショナリにないキー値を頻繁に試行する必要がある場合に、より効率的に値を取得する方法として TryGetValue メソッドを使用する方法も示します。

このコード例は、Dictionary クラスのトピックで取り上げているコード例の一部分です。

' When a program often has to try keys that turn out not to
' be in the dictionary, TryGetValue can be a more efficient 
' way to retrieve values.
Dim value As String = ""
If openWith.TryGetValue("tif",
 value) Then
    Console.WriteLine("For key = ""tif"",
 value = {0}.", value)
Else
    Console.WriteLine("Key = ""tif""
 is not found.")
End If
// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient 
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「Dictionary.Item プロパティ」の関連用語

Dictionary.Item プロパティのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



Dictionary.Item プロパティのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS