dictionary!とは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

Dictionary コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

空で、既定の初期量を備え、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New Dictionary(Of
 TKey, TValue)
C#
public Dictionary ()
C++
public:
Dictionary ()
J#
public Dictionary ()
JScript
public function Dictionary ()
解説解説

Dictionary 内のすべてのキーは既定の等値比較演算子に従って一意である必要があります。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。代わりに、comparer パラメータを受け付けるコンストラクタを使用して、IEqualityComparer ジェネリック インターフェイスの実装を指定することもできます。

メモメモ

コレクションのサイズを推定できる場合は、初期量を指定するコンストラクタを使用すると、Dictionary に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

このコンストラクタは O(1) 操作です。

使用例使用例

文字列キーを含む文字列の空の Dictionary を作成し、Add メソッドを使用していくつかの要素を追加するコード例を次に示します。この例では、重複するキーを追加しようとすると、Add メソッドが ArgumentException をスローすることを示します。

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

Visual Basic
' Create a new dictionary of strings, with string keys.
'
Dim openWith As New Dictionary(Of
 String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt""
 already exists.")
End Try
C#
// Create a new dictionary of strings, with string keys.
//
Dictionary<string, string> openWith =
 
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no 
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is 
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ

Dictionary クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
Dictionary () 空で、既定の初期量を備え、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (ジェネリック IDictionary) 指定した IDictionary から要素をコピーして格納し、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (ジェネリック IEqualityComparer) 空で、既定の初期量を備え、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (Int32) 空で、指定した初期量を備え、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (ジェネリック IDictionary, ジェネリック IEqualityComparer) 指定した IDictionary から要素をコピーして格納し、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (Int32, ジェネリック IEqualityComparer) 空で、指定した初期量を備え、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

Dictionary (SerializationInfo, StreamingContext) シリアル化したデータを使用して、Dictionary クラスの新しいインスタンスを初期化します。
参照参照

関連項目

Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ (SerializationInfo, StreamingContext)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

シリアル化したデータを使用して、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)
Visual Basic (使用法)
Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New Dictionary(Of
 TKey, TValue)(info, context)
C#
protected Dictionary (
    SerializationInfo info,
    StreamingContext context
)
C++
protected:
Dictionary (
    SerializationInfo^ info, 
    StreamingContext context
)
J#
protected Dictionary (
    SerializationInfo info, 
    StreamingContext context
)
JScript
protected function Dictionary (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

Dictionary をシリアル化するために必要な情報を格納している System.Runtime.Serialization.SerializationInfo オブジェクト。

context

Dictionary に関連付けられているシリアル化ストリームのソースおよびデスティネーションを格納している System.Runtime.Serialization.StreamingContext 構造体。

解説解説

このコンストラクタは、逆シリアル化中に、ストリームで送信されたオブジェクトを再構築するために呼び出されます。詳細については、「XML シリアル化および SOAP シリアル化」を参照してください。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
System.Runtime.Serialization

Dictionary コンストラクタ (ジェネリック IDictionary)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IDictionary から要素をコピーして格納し、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    dictionary As IDictionary(Of TKey, TValue)
 _
)
Visual Basic (使用法)
Dim dictionary As IDictionary(Of
 TKey, TValue)

Dim instance As New Dictionary(Of
 TKey, TValue)(dictionary)
C#
public Dictionary (
    IDictionary<TKey,TValue> dictionary
)
C++
public:
Dictionary (
    IDictionary<TKey, TValue>^ dictionary
)
J#
public Dictionary (
    IDictionary<TKey,TValue> dictionary
)
JScript
public function Dictionary (
    dictionary : IDictionary<TKey,TValue>
)

パラメータ

dictionary

新しい Dictionary に要素がコピーされた IDictionary。

例外例外
例外の種類条件

ArgumentNullException

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

ArgumentException

dictionary に、1 つ以上の重複するキーが格納されています。

解説解説

Dictionary 内のすべてのキーは、既定の等値比較演算子に従って一意である必要があります。同様に、元の dictionary 内のすべてのキーも、既定の等値比較演算子に従って一意である必要があります。

新しい Dictionary の初期量は、dictionary 内のすべての要素を格納できるサイズです。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。代わりに、comparer パラメータを受け付けるコンストラクタを使用して、IEqualityComparer ジェネリック インターフェイスの実装を指定することもできます。

このコンストラクタは O(n) 操作です (n は dictionary 内の要素数)。

使用例使用例

Dictionary(ジェネリック IEqualityComparer) コンストラクタを使用し、並べ替えられた別のディクショナリの内容によって Dictionary を初期化する方法を次のコード例に示します。このコード例では、SortedDictionary を作成し、このディクショナリにランダムな順序でデータを読み込みます。次に、SortedDictionary を Dictionary(ジェネリック IEqualityComparer) コンストラクタに渡して、並べ替えられた Dictionary を作成します。これは、特定のポイントで静的になる並べ替えられたディクショナリを構築することが必要である場合に有用です。データを SortedDictionary から Dictionary にコピーすることにより、検索速度が向上します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new sorted dictionary of strings, with string 
        ' keys.
        Dim openWith As New
 SortedDictionary(Of String, String)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys, and 
        ' initialize it with the contents of the sorted dictionary.
        Dim copy As New
 Dictionary(Of String, String)(openWith)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In copy
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string 
        // keys.
        SortedDictionary<string, string>
 openWith = 
            new SortedDictionary<string,
 string>();
        
        // Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");
        
        // Create a Dictionary of strings with string keys, and 
        // initialize it with the contents of the sorted dictionary.
        Dictionary<string, string> copy
 = 
            new Dictionary<string, string>(openWith);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}", 
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
IDictionary
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ (ジェネリック IEqualityComparer)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

空で、既定の初期量を備え、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    comparer As IEqualityComparer(Of TKey)
 _
)
Visual Basic (使用法)
Dim comparer As IEqualityComparer(Of
 TKey)

Dim instance As New Dictionary(Of
 TKey, TValue)(comparer)
C#
public Dictionary (
    IEqualityComparer<TKey> comparer
)
C++
public:
Dictionary (
    IEqualityComparer<TKey>^ comparer
)
J#
public Dictionary (
    IEqualityComparer<TKey> comparer
)
JScript
public function Dictionary (
    comparer : IEqualityComparer<TKey>
)

パラメータ

comparer

キーの比較時に使用する IEqualityComparer 実装。キーの型の既定の EqualityComparer を使用する場合は null 参照 (Visual Basic では Nothing)。

解説解説

このコンストラクタを、StringComparer クラスによって提供される大文字と小文字を区別しない文字列比較演算子に使用して、大文字と小文字を区別しない文字列キーを持つディクショナリを作成します。

Dictionary 内のすべてのキーは指定した比較演算子に従って一意である必要があります。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。comparer が null 参照 (Visual Basic では Nothing) の場合、このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。

メモメモ

コレクションのサイズを推定できる場合は、初期量を指定するコンストラクタを使用すると、Dictionary に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

このコンストラクタは O(1) 操作です。

使用例使用例

現在のカルチャの大文字小文字を区別しない等値比較演算子を使って Dictionary を作成するコード例を次に示します。この例では、小文字のキーを含む要素と大文字のキーを含む要素を合わせて 4 つの要素を追加します。次に、既存のキーとの違いが大文字と小文字の違いだけであるキーを含む要素の追加を試行し、結果の例外をキャッチし、エラー メッセージを表示します。最後に、ディクショナリの要素を表示します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new Dictionary of strings, with string keys 
        ' and a case-insensitive comparer for the current culture.
        Dim openWith As New
 Dictionary(Of String, String)(
 _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the
 dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In openWith
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys 
        // and a case-insensitive comparer for the current culture.
        Dictionary<string, string> openWith
 = 
                      new Dictionary<string,
 string>( 
                          StringComparer.CurrentCultureIgnoreCase);
        
        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same 
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }
        
        // List the contents of the sorted dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, 
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
IEqualityComparer
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ (ジェネリック IDictionary, ジェネリック IEqualityComparer)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IDictionary から要素をコピーして格納し、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    dictionary As IDictionary(Of TKey, TValue),
 _
    comparer As IEqualityComparer(Of TKey)
 _
)
Visual Basic (使用法)
Dim dictionary As IDictionary(Of
 TKey, TValue)
Dim comparer As IEqualityComparer(Of
 TKey)

Dim instance As New Dictionary(Of
 TKey, TValue)(dictionary, comparer)
C#
public Dictionary (
    IDictionary<TKey,TValue> dictionary,
    IEqualityComparer<TKey> comparer
)
C++
public:
Dictionary (
    IDictionary<TKey, TValue>^ dictionary, 
    IEqualityComparer<TKey>^ comparer
)
J#
public Dictionary (
    IDictionary<TKey,TValue> dictionary, 
    IEqualityComparer<TKey> comparer
)
JScript
public function Dictionary (
    dictionary : IDictionary<TKey,TValue>, 
    comparer : IEqualityComparer<TKey>
)

パラメータ

dictionary

新しい Dictionary に要素がコピーされた IDictionary。

comparer

キーの比較時に使用する IEqualityComparer 実装。キーの型の既定の EqualityComparer を使用する場合は null 参照 (Visual Basic では Nothing)。

例外例外
例外の種類条件

ArgumentNullException

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

ArgumentException

dictionary に、1 つ以上の重複するキーが格納されています。

解説解説

このコンストラクタを、StringComparer クラスによって提供される大文字と小文字を区別しない文字列比較演算子に使用して、大文字と小文字を区別しない文字列キーを持つディクショナリを作成します。

Dictionary 内のすべてのキーは、指定した比較演算子に従って一意である必要があります。同様に、元の dictionary 内のすべてのキーも、指定した比較演算子に従って一意である必要があります。

メモメモ

たとえば、comparer が StringComparer クラスによって提供される大文字と小文字を区別しない文字列比較演算子の 1 つであり、dictionary が大文字と小文字を区別しない比較演算子キーを使用しない場合、キーが重複する可能性があります。

新しい Dictionary の初期量は、dictionary 内のすべての要素を格納できるサイズです。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。comparer が null 参照 (Visual Basic では Nothing) の場合、このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。

このコンストラクタは O(n) 操作です (n は dictionary 内の要素数)。

使用例使用例

Dictionary(ジェネリック IDictionary,ジェネリック IEqualityComparer) コンストラクタを使用し、大文字小文字を区別しないで並べ替えられた別のディクショナリの内容によって Dictionary を初期化する方法を次のコード例に示します。このコード例では、大文字小文字を区別しない比較演算子を使って SortedDictionary を作成し、このディクショナリにランダムな順序でデータを読み込みます。次に、大文字小文字を区別しない等値比較演算子と共に SortedDictionary を Dictionary(ジェネリック IDictionary,ジェネリック IEqualityComparer) コンストラクタに渡して、並べ替えられた Dictionary を作成します。これは、特定のポイントで静的になる並べ替えられたディクショナリを構築することが必要である場合に有用です。データを SortedDictionary から Dictionary にコピーすることにより、検索速度が向上します。

メモメモ

この例のように、大文字と小文字を区別しない比較演算子を使用する新しいディクショナリを作成し、それに大文字と小文字を区別する比較演算子を使用するディクショナリのエントリを読み込む場合、入力ディクショナリに大文字と小文字が違うだけのキーがあると例外が発生します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new sorted dictionary of strings, with string 
        ' keys and a case-insensitive comparer.
        Dim openWith As New
 SortedDictionary(Of String, String)(
 _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("Bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys and a 
        ' case-insensitive equality comparer, and initialize it
        ' with the contents of the sorted dictionary.
        Dim copy As New
 Dictionary(Of String, String)(openWith,
 _
            StringComparer.CurrentCultureIgnoreCase)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In copy
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = Bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string 
        // keys and a case-insensitive comparer.
        SortedDictionary<string, string>
 openWith = 
                new SortedDictionary<string,
 string>(
                    StringComparer.CurrentCultureIgnoreCase);
        
        // Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe");
        openWith.Add("Bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");
        
        // Create a Dictionary of strings with string keys and a
        // case-insensitive equality comparer, and initialize it
        // with the contents of the sorted dictionary.
        Dictionary<string, string> copy
 = 
                new Dictionary<string, string>(openWith,
 
                    StringComparer.CurrentCultureIgnoreCase);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}", 
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = Bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
IDictionary
IEqualityComparer
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ (Int32, ジェネリック IEqualityComparer)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

空で、指定した初期量を備え、指定した IEqualityComparer を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    capacity As Integer, _
    comparer As IEqualityComparer(Of TKey)
 _
)
Visual Basic (使用法)
Dim capacity As Integer
Dim comparer As IEqualityComparer(Of
 TKey)

Dim instance As New Dictionary(Of
 TKey, TValue)(capacity, comparer)
C#
public Dictionary (
    int capacity,
    IEqualityComparer<TKey> comparer
)
C++
public:
Dictionary (
    int capacity, 
    IEqualityComparer<TKey>^ comparer
)
J#
public Dictionary (
    int capacity, 
    IEqualityComparer<TKey> comparer
)
JScript
public function Dictionary (
    capacity : int, 
    comparer : IEqualityComparer<TKey>
)

パラメータ

capacity

Dictionary が格納できる要素数の初期値。

comparer

キーの比較時に使用する IEqualityComparer 実装。キーの型の既定の EqualityComparer を使用する場合は null 参照 (Visual Basic では Nothing)。

例外例外
例外の種類条件

ArgumentOutOfRangeException

capacity が 0 未満です。

解説解説

このコンストラクタを、StringComparer クラスによって提供される大文字と小文字を区別しない文字列比較演算子に使用して、大文字と小文字を区別しない文字列キーを持つディクショナリを作成します。

Dictionary 内のすべてのキーは指定した比較演算子に従って一意である必要があります。

Dictionary の容量は、サイズ変更が必要になる前に Dictionary に追加できる要素の数です。Dictionary に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、Dictionary に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。comparer が null 参照 (Visual Basic では Nothing) の場合、このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。

このコンストラクタは O(1) 操作です。

使用例使用例

初期量 5 で、現在のカルチャの大文字小文字を区別しない等値比較演算子を使って Dictionary を作成するコード例を次に示します。この例では、小文字のキーを含む要素と大文字のキーを含む要素を合わせて 4 つの要素を追加します。次に、既存のキーとの違いが大文字と小文字の違いだけであるキーを含む要素の追加を試行し、結果の例外をキャッチし、エラー メッセージを表示します。最後に、ディクショナリの要素を表示します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new Dictionary of strings, with string keys, an
        ' initial capacity of 5, and a case-insensitive equality
        ' comparer.
        Dim openWith As New
 Dictionary(Of String, String)(5,
 _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the
 dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In openWith
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys, an
        // initial capacity of 5, and a case-insensitive equality 
        // comparer.
        Dictionary<string, string> openWith
 = 
                      new Dictionary<string,
 string>(5, 
                          StringComparer.CurrentCultureIgnoreCase);
        
        // Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same 
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }
        
        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, 
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
IEqualityComparer
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary コンストラクタ (Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

空で、指定した初期量を備え、キーの型の既定の等値比較演算子を使用する、Dictionary クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    capacity As Integer _
)
Visual Basic (使用法)
Dim capacity As Integer

Dim instance As New Dictionary(Of
 TKey, TValue)(capacity)
C#
public Dictionary (
    int capacity
)
C++
public:
Dictionary (
    int capacity
)
J#
public Dictionary (
    int capacity
)
JScript
public function Dictionary (
    capacity : int
)

パラメータ

capacity

Dictionary が格納できる要素数の初期値。

例外例外
例外の種類条件

ArgumentOutOfRangeException

capacity が 0 未満です。

解説解説

Dictionary 内のすべてのキーは既定の等値比較演算子に従って一意である必要があります。

Dictionary の容量は、サイズ変更が必要になる前に Dictionary に追加できる要素の数です。Dictionary に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

コレクションのサイズを推定できる場合は、初期量を指定すると、Dictionary に要素を追加するときに、サイズ変更操作を何度も実行する必要がなくなります。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。このコンストラクタは、既定のジェネリック等値比較演算子である EqualityComparer.Default を使用します。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。代わりに、comparer パラメータを受け付けるコンストラクタを使用して、IEqualityComparer ジェネリック インターフェイスの実装を指定することもできます。

このコンストラクタは O(1) 操作です。

使用例使用例

ディクショナリを初期量 4 で作成し、4 つのエントリを設定するコード例を次に示します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new dictionary of strings, with string keys and
        ' an initial capacity of 4.
        Dim openWith As New
 Dictionary(Of String, String)(4)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In openWith
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys and
        // an initial capacity of 4.
        Dictionary<string, string> openWith
 = 
                               new Dictionary<string,
 string>(4);
        
        // Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");
        
        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", 
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary ジェネリック クラス
Dictionary メンバ
System.Collections.Generic 名前空間
EqualityComparer.Default
IEquatable ジェネリック インターフェイス

Dictionary ジェネリック クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

キーと値のコレクションを表します。

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

Visual Basic (宣言)
<SerializableAttribute> _
<ComVisibleAttribute(False)> _
Public Class Dictionary(Of
 TKey, TValue)
    Implements IDictionary(Of TKey, TValue),
 ICollection(Of KeyValuePair(Of TKey, TValue)),
 _
    IEnumerable(Of KeyValuePair(Of TKey, TValue)),
 IDictionary, ICollection, _
    IEnumerable, ISerializable, IDeserializationCallback
Visual Basic (使用法)
Dim instance As Dictionary(Of
 TKey, TValue)
C#
[SerializableAttribute] 
[ComVisibleAttribute(false)] 
public class Dictionary<TKey,TValue>
 : IDictionary<TKey,TValue>, ICollection<KeyValuePair<TKey,TValue>>,
 
    IEnumerable<KeyValuePair<TKey,TValue>>, IDictionary, ICollection,
 IEnumerable, 
    ISerializable, IDeserializationCallback
C++
[SerializableAttribute] 
[ComVisibleAttribute(false)] 
generic<typename TKey, typename TValue>
public ref class Dictionary : IDictionary<TKey,
 TValue>, ICollection<KeyValuePair<TKey, TValue>>, 
    IEnumerable<KeyValuePair<TKey, TValue>>, IDictionary, ICollection,
 IEnumerable, 
    ISerializable, IDeserializationCallback
J#
J# では、ジェネリックな型およびメソッドは使用できますが、新規に宣言することはできません。
JScript
JScript では、ジェネリックな型およびメソッドは使用できません。

型パラメータ

TKey

ディクショナリ内のキーの型。

TValue

ディクショナリ内の値の型。

解説解説

Dictionary ジェネリック クラスにより、キーのセットを値のセットに対応付けることができます。ディクショナリに追加される各エントリは、値とその値に関連付けられたキーで構成されます。Dictionary クラスはハッシュ テーブルとして実装されているため、キーを使用した値の取得は非常に高速で、O(1) に近くなります。

メモメモ

取得速度は、TKey に指定されている型のハッシュ アルゴリズムの品質によって異なります。

オブジェクトが Dictionary のキーとして使用されている場合、そのオブジェクトに対してハッシュ値に影響するような変更を行わないでください。Dictionary 内のすべてのキーは、ディクショナリの等値比較演算子に従って、一意である必要があります。キーを null 参照 (Visual Basic では Nothing) にすることはできませんが、値の型 TValue が参照型である場合、値を null にすることはできます。

Dictionary は、キーが同じであるかどうかを確認するための等値比較の実装を必要とします。comparer パラメータを受け付けるコンストラクタを使用して、IEqualityComparer ジェネリック インターフェイスの実装を指定できます。実装を指定しない場合は、既定のジェネリック等値比較演算子である EqualityComparer.Default が使用されます。型 TKey が System.IEquatable ジェネリック インターフェイスを実装している場合は、既定の等値比較演算子でその実装が使用されます。

メモメモ

たとえば、StringComparer クラスによって提供される大文字と小文字を区別しない文字列比較演算子を使用して、大文字と小文字を区別しない文字列キーを持つディクショナリを作成できます。

Dictionary の容量は、Dictionary が保持できる要素数になります。この実装では、Dictionary の既定の初期量は 3 ですが、この既定値は将来の .NET Framework のバージョンで変更される可能性があります。Dictionary に要素を追加すると、必要に応じて、内部の配列の再割り当てによって容量が自動的に増加します。

列挙処理のために、ディクショナリ内の各アイテムは、値とそのキーを表す KeyValuePair 構造体として処理されます。アイテムが返される順序は未定義です。

C# 言語の foreach ステートメント (C++ の場合は for each、Visual Basic の場合は For Each) は、コレクション内の各要素の型を必要とします。Dictionary はキーと値のコレクションであるため、要素の型は、キーの型や値の型にはなりません。代わりに、要素の型は、キーの型および値の型の KeyValuePair になります。次に例を示します。

C#
foreach (KeyValuePair<int, string>
 kvp in myDictionary) {...}
C++
for each (KeyValuePair<int, String^>
 kvp in myDictionary) {...}
Visual Basic
For Each kvp As KeyValuePair(Of
 Integer, String) In myDictionary
    ...
Next kvp

foreach ステートメントは、列挙子のラッパーです。これは、コレクションからの読み取りだけを許可し、コレクションへの書き込みはできません。

使用例使用例

文字列キーを含む文字列の空の Dictionary を作成し、Add メソッドを使用していくつかの要素を追加するコード例を次に示します。この例では、重複するキーを追加しようとすると、Add メソッドが ArgumentException をスローすることを示します。

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

この例では、プログラムがディクショナリにないキー値を頻繁に試行する必要がある場合に、より効率的に値を取得する方法として TryGetValue メソッドを使用する方法、および ContainsKey メソッドを使用して、Add メソッドを呼び出す前に、キーが存在するかどうかをテストする方法を示します。

この例では、ディクショナリのキーと値を列挙する方法、および Keys プロパティと Values プロパティを使用してキーと値のみを列挙する方法を示します。

最後に、Remove メソッドの使用例を示します。

Visual Basic
Imports System
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new dictionary of strings, with string keys.
        '
        Dim openWith As New
 Dictionary(Of String, String)
        
        ' Add some elements to the dictionary. There are no 
        ' duplicate keys, but some of the values are duplicates.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' The Add method throws an exception if the new key is 
        ' already in the dictionary.
        Try
            openWith.Add("txt", "winword.exe")
        Catch 
            Console.WriteLine("An element with Key = ""txt""
 already exists.")
        End Try

        ' The Item property is the default property, so you 
        ' can omit its name when accessing elements. 
        Console.WriteLine("For key = ""rtf"",
 value = {0}.", _
            openWith("rtf"))
        
        ' The default Item property can be used to change the value
        ' associated with a key.
        openWith("rtf") = "winword.exe"
        Console.WriteLine("For key = ""rtf"",
 value = {0}.", _
            openWith("rtf"))
        
        ' If a key does not exist, setting the default Item property
        ' for that key adds a new key/value pair.
        openWith("doc") = "winword.exe"

        ' The default Item property throws an exception if the requested
        ' key is not in the dictionary.
        Try
            Console.WriteLine("For key = ""tif"",
 value = {0}.", _
                openWith("tif"))
        Catch 
            Console.WriteLine("Key = ""tif""
 is not found.")
        End Try

        ' 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

        ' ContainsKey can be used to test keys before inserting 
        ' them.
        If Not openWith.ContainsKey("ht")
 Then
            openWith.Add("ht", "hypertrm.exe")
            Console.WriteLine("Value added for key = ""ht"":
 {0}", _
                openWith("ht"))
        End If

        ' When you use foreach to enumerate dictionary elements,
        ' the elements are retrieved as KeyValuePair objects.
        Console.WriteLine()
        For Each kvp As
 KeyValuePair(Of String, String)
 In openWith
            Console.WriteLine("Key = {0}, Value = {1}",
 _
                kvp.Key, kvp.Value)
        Next kvp

        ' To get the values alone, use the Values property.
        Dim valueColl As _
            Dictionary(Of String, String).ValueCollection
 = _
            openWith.Values
        
        ' The elements of the ValueCollection are strongly typed
        ' with the type that was specified for dictionary values.
        Console.WriteLine()
        For Each s As String
 In  valueColl
            Console.WriteLine("Value = {0}", s)
        Next s

        ' To get the keys alone, use the Keys property.
        Dim keyColl As _
            Dictionary(Of String, String).KeyCollection
 = _
            openWith.Keys
        
        ' The elements of the KeyCollection are strongly typed
        ' with the type that was specified for dictionary keys.
        Console.WriteLine()
        For Each s As String
 In  keyColl
            Console.WriteLine("Key = {0}", s)
        Next s

        ' Use the Remove method to remove a key/value pair.
        Console.WriteLine(vbLf + "Remove(""doc"")")
        openWith.Remove("doc")
        
        If Not openWith.ContainsKey("doc")
 Then
            Console.WriteLine("Key ""doc""
 is not found.")
        End If

    End Sub

End Class

' This code example produces the following output:
'
'An element with Key = "txt" already exists.
'For key = "rtf", value = wordpad.exe.
'For key = "rtf", value = winword.exe.
'Key = "tif" is not found.
'Key = "tif" is not found.
'Value added for key = "ht": hypertrm.exe
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = winword.exe
'Key = doc, Value = winword.exe
'Key = ht, Value = hypertrm.exe
'
'Value = notepad.exe
'Value = paint.exe
'Value = paint.exe
'Value = winword.exe
'Value = winword.exe
'Value = hypertrm.exe
'
'Key = txt
'Key = bmp
'Key = dib
'Key = rtf
'Key = doc
'Key = ht
'
'Remove("doc")
'Key "doc" is not found.
'
C#
using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys.
        //
        Dictionary<string, string> openWith
 = 
            new Dictionary<string, string>();

        // Add some elements to the dictionary. There are no 
        // duplicate keys, but some of the values are duplicates.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // The Add method throws an exception if the new key is 
        // already in the dictionary.
        try
        {
            openWith.Add("txt", "winword.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("An element with Key = \"txt\" already
 exists.");
        }

        // The Item property is another name for the indexer, so you
 
        // can omit its name when accessing elements. 
        Console.WriteLine("For key = \"rtf\", value = {0}.",
 
            openWith["rtf"]);

        // The indexer can be used to change the value associated
        // with a key.
        openWith["rtf"] = "winword.exe";
        Console.WriteLine("For key = \"rtf\", value = {0}.",
 
            openWith["rtf"]);

        // If a key does not exist, setting the indexer for that key
        // adds a new key/value pair.
        openWith["doc"] = "winword.exe";

        // The indexer throws an exception if the requested key is
        // not in the dictionary.
        try
        {
            Console.WriteLine("For key = \"tif\", value = {0}.",
 
                openWith["tif"]);
        }
        catch (KeyNotFoundException)
        {
            Console.WriteLine("Key = \"tif\" is not found.");
        }

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

        // ContainsKey can be used to test keys before inserting 
        // them.
        if (!openWith.ContainsKey("ht"))
        {
            openWith.Add("ht", "hypertrm.exe");
            Console.WriteLine("Value added for key = \"ht\":
 {0}", 
                openWith["ht"]);
        }

        // When you use foreach to enumerate dictionary elements,
        // the elements are retrieved as KeyValuePair objects.
        Console.WriteLine();
        foreach( KeyValuePair<string, string>
 kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", 
                kvp.Key, kvp.Value);
        }

        // To get the values alone, use the Values property.
        Dictionary<string, string>.ValueCollection
 valueColl =
            openWith.Values;

        // The elements of the ValueCollection are strongly typed
        // with the type that was specified for dictionary values.
        Console.WriteLine();
        foreach( string s in
 valueColl )
        {
            Console.WriteLine("Value = {0}", s);
        }

        // To get the keys alone, use the Keys property.
        Dictionary<string, string>.KeyCollection
 keyColl =
            openWith.Keys;

        // The elements of the KeyCollection are strongly typed
        // with the type that was specified for dictionary keys.
        Console.WriteLine();
        foreach( string s in
 keyColl )
        {
            Console.WriteLine("Key = {0}", s);
        }

        // Use the Remove method to remove a key/value pair.
        Console.WriteLine("\nRemove(\"doc\")");
        openWith.Remove("doc");

        if (!openWith.ContainsKey("doc"))
        {
            Console.WriteLine("Key \"doc\" is not found.");
        }
    }
}

/* This code example produces the following output:

An element with Key = "txt" already exists.
For key = "rtf", value = wordpad.exe.
For key = "rtf", value = winword.exe.
Key = "tif" is not found.
Key = "tif" is not found.
Value added for key = "ht": hypertrm.exe

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = winword.exe
Key = doc, Value = winword.exe
Key = ht, Value = hypertrm.exe

Value = notepad.exe
Value = paint.exe
Value = paint.exe
Value = winword.exe
Value = winword.exe
Value = hypertrm.exe

Key = txt
Key = bmp
Key = dib
Key = rtf
Key = doc
Key = ht

Remove("doc")
Key "doc" is not found.
 */
継承階層継承階層
System.Object
  System.Collections.Generic.Dictionary
スレッド セーフスレッド セーフ

この型の public static (Visual Basic では Shared) メンバは、スレッド セーフです。すべてのインスタンス メンバがスレッド セーフになるかどうかは保証されていません。

コレクションが変更されない限り、Dictionary では、複数の読み込み操作が同時に発生しても問題ありません。ただし、コレクションの列挙処理は、本質的にはスレッド セーフな処理ではありません。まれに書き込みアクセスによって列挙処理で競合が発生する場合、列挙処理が完了するまでコレクションをロックする必要があります。コレクションに対し複数のスレッドがアクセスして読み取りや書き込みを行うことができるようにするには、独自に同期化を実装する必要があります。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
Dictionary メンバ
System.Collections.Generic 名前空間
IDictionary
SortedList
KeyValuePair
IEqualityComparer

Dictionary プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ Values Dictionary 内の値を格納しているコレクションを取得します。
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Collections.IDictionary.Values IDictionary 内の値を格納している ICollection を取得します。
参照参照

関連項目

Dictionary ジェネリック クラス
System.Collections.Generic 名前空間
IDictionary
SortedList
KeyValuePair
IEqualityComparer

Dictionary メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Add 指定したキーと値をディクショナリに追加します。
パブリック メソッド Clear Dictionary からすべてのキーと値を削除します。
パブリック メソッド ContainsKey 指定したキーが Dictionary に格納されているかどうかを判断します。
パブリック メソッド ContainsValue Dictionary に特定の値が格納されているかどうかを判断します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetEnumerator Dictionary を反復処理する列挙子を返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetObjectData System.Runtime.Serialization.ISerializable インターフェイスを実装し、Dictionary インスタンスをシリアル化するために必要なデータを返します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド OnDeserialization System.Runtime.Serialization.ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Remove 指定したキーを持つ値を Dictionary から削除します。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
パブリック メソッド TryGetValue 指定したキーに関連付けられている値を取得します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Add 指定した値を、指定したキーと共に ICollection に追加します。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Contains ICollection に特定のキーと値が格納されているかどうかを判断します。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.CopyTo 指定した配列インデックスを開始位置として、KeyValuePair 型の配列に ICollection の要素をコピーします。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Remove ディクショナリからキーと値を削除します。
インターフェイスの明示的な実装 System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>.GetEnumerator コレクションを反復処理する列挙子を返します。
インターフェイスの明示的な実装 System.Collections.ICollection.CopyTo 指定した配列インデックスを開始位置として、配列に ICollection の要素をコピーします。
インターフェイスの明示的な実装 System.Collections.IDictionary.Add 指定したキーと値をディクショナリに追加します。
インターフェイスの明示的な実装 System.Collections.IDictionary.Contains 指定したキーの要素が IDictionary に格納されているかどうかを確認します。
インターフェイスの明示的な実装 System.Collections.IDictionary.GetEnumerator IDictionary の IDictionaryEnumerator を返します。
インターフェイスの明示的な実装 System.Collections.IDictionary.Remove 指定したキーを持つ要素を IDictionary から削除します。
インターフェイスの明示的な実装 System.Collections.IEnumerable.GetEnumerator コレクションを反復処理する列挙子を返します。
参照参照

関連項目

Dictionary ジェネリック クラス
System.Collections.Generic 名前空間
IDictionary
SortedList
KeyValuePair
IEqualityComparer

Dictionary メンバ

キーと値のコレクションを表します。

Dictionary ジェネリック型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
( プロテクト コンストラクタ も参照)
  名前 説明
パブリック メソッド Dictionary オーバーロードされます。 Dictionary クラスの新しいインスタンスを初期化します。
プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド Dictionary オーバーロードされます。 Dictionary クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ Values Dictionary 内の値を格納しているコレクションを取得します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Add 指定したキーと値をディクショナリに追加します。
パブリック メソッド Clear Dictionary からすべてのキーと値を削除します。
パブリック メソッド ContainsKey 指定したキーが Dictionary に格納されているかどうかを判断します。
パブリック メソッド ContainsValue Dictionary に特定の値が格納されているかどうかを判断します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetEnumerator Dictionary を反復処理する列挙子を返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetObjectData System.Runtime.Serialization.ISerializable インターフェイスを実装し、Dictionary インスタンスをシリアル化するために必要なデータを返します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド OnDeserialization System.Runtime.Serialization.ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド Remove 指定したキーを持つ値を Dictionary から削除します。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
パブリック メソッド TryGetValue 指定したキーに関連付けられている値を取得します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Add 指定した値を、指定したキーと共に ICollection に追加します。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Contains ICollection に特定のキーと値が格納されているかどうかを判断します。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.CopyTo 指定した配列インデックスを開始位置として、KeyValuePair 型の配列に ICollection の要素をコピーします。
インターフェイスの明示的な実装 System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>.Remove ディクショナリからキーと値を削除します。
インターフェイスの明示的な実装 System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>.GetEnumerator コレクションを反復処理する列挙子を返します。
インターフェイスの明示的な実装 System.Collections.ICollection.CopyTo 指定した配列インデックスを開始位置として、配列に ICollection の要素をコピーします。
インターフェイスの明示的な実装 System.Collections.IDictionary.Add 指定したキーと値をディクショナリに追加します。
インターフェイスの明示的な実装 System.Collections.IDictionary.Contains 指定したキーの要素が IDictionary に格納されているかどうかを確認します。
インターフェイスの明示的な実装 System.Collections.IDictionary.GetEnumerator IDictionary の IDictionaryEnumerator を返します。
インターフェイスの明示的な実装 System.Collections.IDictionary.Remove 指定したキーを持つ要素を IDictionary から削除します。
インターフェイスの明示的な実装 System.Collections.IEnumerable.GetEnumerator コレクションを反復処理する列挙子を返します。
インターフェイスの明示的な実装 System.Collections.IDictionary.Values IDictionary 内の値を格納している ICollection を取得します。
参照参照

関連項目

Dictionary ジェネリック クラス
System.Collections.Generic 名前空間
IDictionary
SortedList
KeyValuePair
IEqualityComparer

急上昇のことば

line. . .
値千金
ケセラセラ
概念
膳場貴子
このページでは「.NET Framework クラス ライブラリ リファレンス」からdictionary!を検索した結果を表示しています。
Weblioに収録されているすべての辞書からdictionary!を検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からdictionary! を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「dictionary!」の関連用語

1
Dictionary.KeyCollection コンストラクタ
.NET Framework クラス ライブラリ リファレンス
70% |||||

2
Dictionary.ValueCollection コンストラクタ
.NET Framework クラス ライブラリ リファレンス
70% |||||

3
thefreedictionary
アルファベット表記辞典
56% |||||

4
辞書
OR事典
56% |||||

5
エヌ‐イー‐ディー デジタル大辞泉
56% |||||

6
オー‐イー‐ディー デジタル大辞泉
56% |||||

7
ピー‐オー‐ディー デジタル大辞泉
56% |||||

8
Dictionary コンストラクタ
.NET Framework クラス ライブラリ リファレンス
52% |||||

9
English-Japanese dictionary
日本語表現辞典
52% |||||

10
Dictionary of Key
ウィキペディア小見出し辞書
50% |||||

dictionary!のお隣キーワード

DICOM

dict

dictate

dictatorship

diction

dictionaries

dictionary

Dictionary.Add メソッド

DictionaryBase.Clear メソッド

DictionaryBase.CopyTo メソッド

DictionaryBase.Count プロパティ

DictionaryBase.Dictionary プロパティ

DictionaryBase.GetEnumerator メソッド

検索ランキング

   

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


dictionary!のページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2025 GRAS Group, Inc.RSS