CollectionsUtil クラス

リファレンス

定義

名前空間:: System.Collections.Specialized

アセンブリ:: System.dll, System.Collections.NonGeneric.dll

アセンブリ:: System.Collections.NonGeneric.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

ソース:: CollectionsUtil.cs

ソース:: CollectionsUtil.cs

ソース:: CollectionsUtil.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

大文字小文字を無視する文字列のコレクションを作成します。

public ref class CollectionsUtil

public class CollectionsUtil

type CollectionsUtil = class

Public Class CollectionsUtil

継承: Object
CollectionsUtil

例

次の例では、ハッシュテーブルと並べ替えられたリストの 2 つのコレクションを使用して、都市のグループの母集団の値を保持します。値は、市区町村名をキーとして使用してコレクションから取得されます。市区町村名は大文字と小文字が混在しており、大文字と小文字を区別しないキーとして使用されます。

#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::Collections::Specialized;

ref class TestCollectionsUtils
{
public:
    static void Main()
    {
        Hashtable^ population1 = CollectionsUtil::CreateCaseInsensitiveHashtable();

        population1["Trapperville"] = 15;
        population1["Doggerton"] = 230;
        population1["New Hollow"] = 1234;
        population1["McHenry"] = 185;

        // Select cities from the table using mixed case.
        Console::WriteLine("Case insensitive hashtable results:\n");
        Console::WriteLine("{0}'s population is: {1}", "Trapperville", population1["trapperville"]);
        Console::WriteLine("{0}'s population is: {1}", "Doggerton", population1["DOGGERTON"]);
        Console::WriteLine("{0}'s population is: {1}", "New Hollow", population1["New hoLLow"]);
        Console::WriteLine("{0}'s population is: {1}", "McHenry", population1["MchenrY"]);

        SortedList^ population2 = CollectionsUtil::CreateCaseInsensitiveSortedList();

        for each (String^ city in population1->Keys)
        {
            population2->Add(city, population1[city]);
        }

        // Select cities from the sorted list using mixed case.
        Console::WriteLine("\nCase insensitive sorted list results:\n");
        Console::WriteLine("{0}'s population is: {1}", "Trapperville", population2["trapPeRVille"]);
        Console::WriteLine("{0}'s population is: {1}", "Doggerton", population2["dOGGeRtON"]);
        Console::WriteLine("{0}'s population is: {1}", "New Hollow", population2["nEW hOLLOW"]);
        Console::WriteLine("{0}'s population is: {1}", "McHenry", population2["MchEnrY"]);
    }
};

int main()
{
    TestCollectionsUtils::Main();
}

// This program displays the following output to the console
//
// Case insensitive hashtable results:
//
// Trapperville's population is: 15
// Doggerton's population is: 230
// New Hollow's population is: 1234
// McHenry's population is: 185
//
// Case insensitive sorted list results:
//
// Trapperville's population is: 15
// Doggerton's population is: 230
// New Hollow's population is: 1234
// McHenry's population is: 185

using System;
using System.Collections;
using System.Collections.Specialized;

class TestCollectionsUtils
{
    public static void Main()
    {
        Hashtable population1 = CollectionsUtil.CreateCaseInsensitiveHashtable();

        population1["Trapperville"] = 15;
        population1["Doggerton"] = 230;
        population1["New Hollow"] = 1234;
        population1["McHenry"] = 185;

        // Select cities from the table using mixed case.
        Console.WriteLine("Case insensitive hashtable results:\n");
        Console.WriteLine("{0}'s population is: {1}", "Trapperville", population1["trapperville"]);
        Console.WriteLine("{0}'s population is: {1}", "Doggerton", population1["DOGGERTON"]);
        Console.WriteLine("{0}'s population is: {1}", "New Hollow", population1["New hoLLow"]);
        Console.WriteLine("{0}'s population is: {1}", "McHenry", population1["MchenrY"]);

        SortedList population2 = CollectionsUtil.CreateCaseInsensitiveSortedList();

        foreach (string city in population1.Keys)
        {
           population2.Add(city, population1[city]);
        }

        // Select cities from the sorted list using mixed case.
        Console.WriteLine("\nCase insensitive sorted list results:\n");
        Console.WriteLine("{0}'s population is: {1}", "Trapperville", population2["trapPeRVille"]);
        Console.WriteLine("{0}'s population is: {1}", "Doggerton", population2["dOGGeRtON"]);
        Console.WriteLine("{0}'s population is: {1}", "New Hollow", population2["nEW hOLLOW"]);
        Console.WriteLine("{0}'s population is: {1}", "McHenry", population2["MchEnrY"]);
    }
}

// This program displays the following output to the console
//
// Case insensitive hashtable results:
//
// Trapperville's population is: 15
// Doggerton's population is: 230
// New Hollow's population is: 1234
// McHenry's population is: 185
//
// Case insensitive sorted list results:
//
// Trapperville's population is: 15
// Doggerton's population is: 230
// New Hollow's population is: 1234
// McHenry's population is: 185

Imports System.Collections
Imports System.Collections.Specialized

Class TestCollectionsUtils
    Public Shared Sub Main()
        Dim population1 As Hashtable = CollectionsUtil.CreateCaseInsensitiveHashtable()

        population1("Trapperville") = 15
        population1("Doggerton") = 230
        population1("New Hollow") = 1234
        population1("McHenry") = 185

        ' Select cities from the table using mixed case.
        Console.WriteLine("Case insensitive hashtable results:" + Environment.NewLine)
        Console.WriteLine("{0}'s population is: {1}", "Trapperville", population1("trapperville"))
        Console.WriteLine("{0}'s population is: {1}", "Doggerton", population1("DOGGERTON"))
        Console.WriteLine("{0}'s population is: {1}", "New Hollow", population1("New hoLLow"))
        Console.WriteLine("{0}'s population is: {1}", "McHenry", population1("MchenrY"))

        Dim population2 As SortedList = CollectionsUtil.CreateCaseInsensitiveSortedList()

        For Each city As String In population1.Keys
            population2.Add(city, population1(city))
        Next city

        ' Select cities from the sorted list using mixed case.
        Console.WriteLine(Environment.NewLine + "Case insensitive sorted list results:" + Environment.NewLine)
        Console.WriteLine("{0}'s population is: {1}", "Trapperville", population2("trapPeRVille"))
        Console.WriteLine("{0}'s population is: {1}", "Doggerton", population2("dOGGeRtON"))
        Console.WriteLine("{0}'s population is: {1}", "New Hollow", population2("nEW hOLLOW"))
        Console.WriteLine("{0}'s population is: {1}", "McHenry", population2("MchEnrY"))
    End Sub
End Class

' This program displays the following output to the console
'
' Case insensitive hashtable results:
'
' Trapperville's population is: 15
' Doggerton's population is: 230
' New Hollow's population is: 1234
' McHenry's population is: 185
'
' Case insensitive sorted list results:
'
' Trapperville's population is: 15
' Doggerton's population is: 230
' New Hollow's population is: 1234
' McHenry's population is: 185

注釈

これらのメソッドは、ハッシュコードプロバイダーと比較子の大文字と小文字を区別しない実装を使用して、コレクションの大文字と小文字を区別しないインスタンスを生成します。結果のインスタンスは、そのクラスの他のインスタンスと同様に使用できますが、動作が異なる場合があります。

たとえば、キー "hello" と "HELLO" を持つ 2 つのオブジェクトをハッシュテーブルに追加するとします。大文字と小文字を区別するハッシュテーブルでは、2 つの異なるエントリが作成されます。一方、大文字と小文字を区別しないハッシュテーブルでは、2 番目のオブジェクトを追加するときに例外がスローされます。

コンストラクター

CollectionsUtil()

CollectionsUtil クラスの新しいインスタンスを初期化します。

メソッド

CreateCaseInsensitiveHashtable()	既定の初期量を備えた、大文字と小文字を区別しない Hashtable クラスの新しいインスタンスを作成します。
CreateCaseInsensitiveHashtable(IDictionary)	コピーされるエントリ数と同じ初期量を備えた、Hashtable クラスの大文字と小文字を区別しない新しいインスタンスに、指定したディクショナリからエントリをコピーします。
CreateCaseInsensitiveHashtable(Int32)	指定した初期量を備えた、大文字と小文字を区別しない Hashtable クラスの新しいインスタンスを作成します。
CreateCaseInsensitiveSortedList()	文字列の大文字と小文字を区別しない SortedList クラスの新しいインスタンスを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

スレッドセーフ

では Hashtable 、1 つのライターと複数のリーダーを同時にサポートできます。複数のライターをサポートするには、メソッドによって返されるラッパーを使用して、すべての操作を実行する Synchronized(Hashtable) 必要があります。

は SortedList 、コレクションが変更されていない限り、複数のリーダーを同時にサポートできます。のスレッドセーフを保証するには、 SortedListメソッドによって返されるラッパーを使用して、すべての操作を実行する Synchronized(SortedList) 必要があります。

コレクションの列挙は、本質的にスレッドセーフな手続きではありません。コレクションが同期されていても、他のスレッドがコレクションを変更する場合があり、このときは列挙子から例外がスローされます。列挙処理を確実にスレッドセーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

次の方法で共有

CollectionsUtil クラス

定義

例

注釈

コンストラクター

メソッド

適用対象

スレッドセーフ

こちらもご覧ください

その他のリソース

次の方法で共有

CollectionsUtil クラス

定義

例

注釈

コンストラクター

メソッド

適用対象

スレッド セーフ

こちらもご覧ください

その他のリソース

スレッドセーフ