Dictionary.System.Collections.IDictionary.Contains メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Dictionary.System.Collections.IDictionary.Contains メソッド

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

指定したキーの要素が IDictionary に格納されているかどうかを確認します。

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

Visual Basic (宣言)

Private Function System.Collections.IDictionary.Contains
 ( _
    key As Object _
) As Boolean Implements
 IDictionary.Contains

Visual Basic (使用法)

Dim instance As Dictionary(Of
 TKey, TValue)
Dim key As Object
Dim returnValue As Boolean

returnValue = CType(instance, IDictionary).Contains(key)

bool IDictionary.Contains (
    Object key
)

C++

private:
virtual bool System.Collections.IDictionary.Contains (
    Object^ key
) sealed = IDictionary::Contains

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

key: IDictionary 内で検索されるキー。

戻り値
指定したキーを持つ要素が IDictionary に格納されている場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、key が、Dictionary のキーの型 TKey に代入できない型である場合に、false を返します。

このメソッドは O(1) 操作に近くなります。

使用例

Dictionary で、System.Collections.IDictionary インターフェイスの System.Collections.IDictionary.Contains メソッドを使用する方法を次のコード例に示します。この例では、データ型が適切でないキーを指定した場合に、メソッドによって false が返されることを示しています。

次のコード例は、System.Collections.IDictionary.Add メソッドのトピックで取り上げている例および出力の一部分です。

Visual Basic

Imports System
Imports System.Collections
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main()
 

        ' Create a new dictionary of strings, with string keys,
        ' and access it using the IDictionary interface.
        '
        Dim openWith As IDictionary = _
            New Dictionary(Of String,
 String)
        
        ' Add some elements to the dictionary. There are no 
        ' duplicate keys, but some of the values are duplicates.
        ' IDictionary.Add throws an exception if incorrect types
        ' are supplied for key or value.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
<br /><span space="preserve">...</span><br
 />        ' Contains can be used to test keys before inserting
 
        ' them.
        If Not openWith.Contains("ht")
 Then
            openWith.Add("ht", "hypertrm.exe")
            Console.WriteLine("Value added for key = ""ht"":
 {0}", _
                openWith("ht"))
        End If

        ' IDictionary.Contains returns False if the wrong data 
        ' type is supplied.
        Console.WriteLine("openWith.Contains(29.7) returns {0}",
 _
            openWith.Contains(29.7))
<br /><span space="preserve">...</span><br
 />
    End Sub

End Class

using System;
using System.Collections;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys,
        // and access it using the IDictionary interface.
        //
        IDictionary openWith = new Dictionary<string,
 string>();

        // Add some elements to the dictionary. There are no 
        // duplicate keys, but some of the values are duplicates.
        // IDictionary.Add throws an exception if incorrect types
        // are supplied for key or value.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");
<br /><span space="preserve">...</span><br /> 
       // Contains can be used to test keys before inserting 
        // them.
        if (!openWith.Contains("ht"))
        {
            openWith.Add("ht", "hypertrm.exe");
            Console.WriteLine("Value added for key = \"ht\":
 {0}", 
                openWith["ht"]);
        }

        // IDictionary.Contains returns false if the wrong data
        // type is supplied.
        Console.WriteLine("openWith.Contains(29.7) returns {0}",
            openWith.Contains(29.7));
<br /><span space="preserve">...</span><br /> 
   }
}