ConcurrentDictionary<TKey,TValue>.GetOrAdd メソッド

定義

キーがまだ存在しない場合に、ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加します。 新しい値、または既にキーが存在する場合は既存の値を返します。

オーバーロード

GetOrAdd(TKey, Func<TKey,TValue>)

キーがまだ存在しない場合に、指定された関数を使用して ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加します。 新しい値、またはキーが存在する場合は既存の値を返します。

GetOrAdd(TKey, TValue)

キーがまだ存在しない場合に、ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加します。 新しい値、またはキーが存在する場合は既存の値を返します。

GetOrAdd<TArg>(TKey, Func<TKey,TArg,TValue>, TArg)

キーがまだ存在しない場合は、指定された関数と引数を使用して ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加し、キーが存在する場合は既存の値を返します。

次の例は、 メソッドを呼び出す方法を GetOrAdd 示しています。

class CD_GetOrAddOrUpdate
{
    // Demonstrates:
    //      ConcurrentDictionary<TKey, TValue>.AddOrUpdate()
    //      ConcurrentDictionary<TKey, TValue>.GetOrAdd()
    //      ConcurrentDictionary<TKey, TValue>[]
    static void Main()
    {
        // Construct a ConcurrentDictionary
        ConcurrentDictionary<int, int> cd = new ConcurrentDictionary<int, int>();

        // Bombard the ConcurrentDictionary with 10000 competing AddOrUpdates
        Parallel.For(0, 10000, i =>
        {
            // Initial call will set cd[1] = 1.
            // Ensuing calls will set cd[1] = cd[1] + 1
            cd.AddOrUpdate(1, 1, (key, oldValue) => oldValue + 1);
        });

        Console.WriteLine("After 10000 AddOrUpdates, cd[1] = {0}, should be 10000", cd[1]);

        // Should return 100, as key 2 is not yet in the dictionary
        int value = cd.GetOrAdd(2, (key) => 100);
        Console.WriteLine("After initial GetOrAdd, cd[2] = {0} (should be 100)", value);

        // Should return 100, as key 2 is already set to that value
        value = cd.GetOrAdd(2, 10000);
        Console.WriteLine("After second GetOrAdd, cd[2] = {0} (should be 100)", value);
    }
}

GetOrAdd(TKey, Func<TKey,TValue>)

ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs

キーがまだ存在しない場合に、指定された関数を使用して ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加します。 新しい値、またはキーが存在する場合は既存の値を返します。

public TValue GetOrAdd (TKey key, Func<TKey,TValue> valueFactory);

パラメーター

key
TKey

追加する要素のキー。

valueFactory
Func<TKey,TValue>

キーの値を生成するために使用される関数。

戻り値

TValue

キーの値。 キーがディクショナリに既に存在する場合はキーの既存の値、キーがディクショナリに存在していなかった場合は新しい値になります。

例外

key または valueFactorynull です。

ディレクトリに含まれている要素が多すぎます。

注釈

ディクショナリに対する変更および書き込み操作では、 ConcurrentDictionary<TKey,TValue> スレッドの安全性を確保するために、きめ細かいロックを使用します。 (ディクショナリに対する読み取り操作は、ロックなしの方法で実行されます)。ただし、ロックの valueFactory 下で不明なコードを実行することによって発生する可能性のある問題を回避するために、デリゲートはロックの外部で呼び出されます。 したがって、 GetOrAdd は クラスに対する他のすべての操作 ConcurrentDictionary<TKey,TValue> に関してアトミックではありません。

キー/値は値の生成中に valueFactory 別のスレッドによって挿入できるため、実行されたから valueFactory といって、生成された値がディクショナリに挿入されて返されるという理由だけでは信頼できません。 異なるスレッドで同時に を呼び出 GetOrAdd す場合は、 valueFactory 複数回呼び出すことができますが、ディクショナリに追加されるキーと値のペアは 1 つだけです。

戻り値は、ディクショナリ内のキーの存在と、 が呼び出された後 GetOrAdd に別のスレッドによってキー/値が挿入されるかどうかによって異なりますが、その前に valueFactory 値が生成されます。

シナリオ 戻り値
キーは既にディクショナリにあります。 既存の値が返されます。
キーがディクショナリにありません。 valueFactory は値を生成します。 キーの再確認時に、キーが見つかりません。 キー/値がディクショナリに挿入され、値が返されます。
キーがディクショナリにありません。 valueFactory は値を生成します。 値の生成中 valueFactory に、別のスレッドによってキーの値が挿入されます。 を実行した後 valueFactory 、キーを再チェックすると、他のスレッドによって挿入されたキーが見つかります。 他のスレッドによって挿入された値が返されます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

GetOrAdd(TKey, TValue)

ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs

キーがまだ存在しない場合に、ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加します。 新しい値、またはキーが存在する場合は既存の値を返します。

public TValue GetOrAdd (TKey key, TValue value);

パラメーター

key
TKey

追加する要素のキー。

value
TValue

キーがまだ存在しない場合に追加する値。

戻り値

TValue

キーの値。 キーがディクショナリに既に存在する場合はキーの既存の値、キーがディクショナリに存在していなかった場合は新しい値になります。

例外

keynullです。

ディレクトリに含まれている要素が多すぎます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

GetOrAdd<TArg>(TKey, Func<TKey,TArg,TValue>, TArg)

ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs
ソース:
ConcurrentDictionary.cs

キーがまだ存在しない場合は、指定された関数と引数を使用して ConcurrentDictionary<TKey,TValue> にキーと値のペアを追加し、キーが存在する場合は既存の値を返します。

public TValue GetOrAdd<TArg> (TKey key, Func<TKey,TArg,TValue> valueFactory, TArg factoryArgument);

型パラメーター

TArg

valueFactory渡す引数の型。

パラメーター

key
TKey

追加する要素のキー。

valueFactory
Func<TKey,TArg,TValue>

キーの値を生成するために使用される関数。

factoryArgument
TArg

valueFactory に渡す引数値。

戻り値

TValue

キーの値。 キーがディクショナリに既に存在する場合はキーの既存の値、キーがディクショナリに存在していなかった場合は新しい値になります。

例外

keynull 参照 (Visual Basic では Nothing) です。

ディレクトリに含まれている要素が多すぎます。

注釈

ディクショナリに対する変更および書き込み操作では、 ConcurrentDictionary<TKey,TValue> スレッドの安全性を確保するために、きめ細かいロックを使用します。 (ディクショナリに対する読み取り操作は、ロックなしの方法で実行されます)。ただし、ロックの valueFactory 下で不明なコードを実行することによって発生する可能性のある問題を回避するために、デリゲートはロックの外部で呼び出されます。 したがって、 GetOrAdd は クラスに対する他のすべての操作 ConcurrentDictionary<TKey,TValue> に関してアトミックではありません。

キー/値は値の生成中に valueFactory 別のスレッドによって挿入できるため、実行されたから valueFactory といって、生成された値がディクショナリに挿入されて返されるという理由だけでは信頼できません。 異なるスレッドで同時に を呼び出 GetOrAdd す場合は、 valueFactory 複数回呼び出すことができますが、ディクショナリに追加されるキーと値のペアは 1 つだけです。

戻り値は、ディクショナリ内のキーの存在と、 が呼び出された後 GetOrAdd に別のスレッドによってキー/値が挿入されるかどうかによって異なりますが、その前に valueFactory 値が生成されます。

シナリオ 戻り値
キーは既にディクショナリにあります。 既存の値が返されます。
キーがディクショナリにありません。 valueFactory は値を生成します。 キーの再確認時に、キーが見つかりません。 キー/値がディクショナリに挿入され、値が返されます。
キーがディクショナリにありません。 valueFactory は値を生成します。 値の生成中 valueFactory に、別のスレッドによってキーの値が挿入されます。 を実行した後 valueFactory 、キーを再チェックすると、他のスレッドによって挿入されたキーが見つかります。 他のスレッドによって挿入された値が返されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.7.2, 4.8, 4.8.1
.NET Standard 2.1