ConditionalWeakTable<TKey,TValue>.CreateValueCallback 代理人

定義

名前空間:

System.Runtime.CompilerServices

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

ConditionalWeakTable.cs

ConditionalWeakTable<TKey,TValue> オブジェクトにキー/値ペアの一部として追加する既定値以外の値を作成するメソッドを表します。

C#

public delegate TValue ConditionalWeakTable<TKey,TValue>.CreateValueCallback(TKey key) where TKey : class where TValue : class;

パラメーター

key

TKey

作成する値に属しているキー。

戻り値

TValue

指定したキーにアタッチする値を表す、参照型のインスタンス。

例

次の例では、 MainClass クラスと クラスを MainInfo 定義します。 MainInfo は、インスタンスに関する情報を MainClass 提供します。 また、デリゲートに割り当てConditionalWeakTable<TKey,TValue>.CreateValueCallback、メソッドに渡すことができる静的 (SharedVisual Basic の場合) CreateAttachedValue メソッドもGetValue定義します。 この例では、 メソッドを GetValue 呼び出して、 MainClass オブジェクトとそれに対応する MainInfo オブジェクトをテーブルに ConditionalWeakTable<TKey,TValue> 追加します。 この例では、 メソッドと GetOrCreateValue メソッドを呼び出してテーブルにAddキーと値のペアを追加し、メソッドを呼び出してTryGetValue既存のキーに属する値を取得する方法も示しています。

C#

using System;
using System.Reflection;
using System.Runtime.CompilerServices;

public class Example
{
   string Name; 
   
   public Example(string name)
   {
      this.Name = name;
   }
   
   public override string ToString()
   {
      return this.Name;
   }
}

// Define a class to contain information about each Example instance.
public class ExampleInfo
{
   public string Name;
   public int Methods;
   public int Properties;
   
   public override string ToString()
   {
      return String.Format("{0}: {1} Methods, {2} Properties", 
                           this.Name, this.Methods, this.Properties);
   }
}

public class ExampleTest
{
   private static BindingFlags flags = BindingFlags.Public | BindingFlags.Instance;

   public static void Main()
   {
      Example ex1 = new Example("ex1");
      Example ex2 = new Example("ex2");
      Example ex3 = new Example("ex3");
      
      ExampleInfo exInfo1 = new ExampleInfo(); 
      exInfo1.Name = ex1.ToString();
      exInfo1.Methods = ex1.GetType().GetMethods(flags).Length;
      exInfo1.Properties = ex1.GetType().GetProperties(flags).Length;
      
      ExampleInfo exInfo3 = new ExampleInfo(); 
      exInfo3.Name = ex3.ToString();
      exInfo3.Methods = ex3.GetType().GetMethods(flags).Length;
      exInfo3.Properties = ex3.GetType().GetProperties(flags).Length;

      var attached = new ConditionalWeakTable<Example, ExampleInfo>();
      ExampleInfo value = null;

      // Attach a property to ex1 using the Add method, then retrieve it.
      attached.Add(ex1, exInfo1);
      if (attached.TryGetValue(ex1, out value))
         Console.WriteLine("{0}, {1}", ex1, value);
      else
         Console.WriteLine("{0} does not have an attached property.", ex1);

      // Attempt to retrieve the value attached to ex2.
      value = attached.GetValue(ex2, ExampleTest.CreateAttachedValue);      
      if (attached.TryGetValue(ex2, out value))
         Console.WriteLine("{0}, {1}", ex2, value);
      else 
         Console.WriteLine("{0} does not have an attached property.", ex2);
      
      // Attempt to retrieve the value attached to ex3.
      value = attached.GetOrCreateValue(ex3);
      Console.WriteLine("{0}, {1}", ex3, value);
   }

   public static ExampleInfo CreateAttachedValue(Example ex)
   {
      ExampleInfo info = new ExampleInfo();
      info.Name = ex.ToString();
      info.Methods = ex.GetType().GetMethods(flags).Length;
      info.Properties = ex.GetType().GetProperties(flags).Length;
      return info;
   }
}
// The example displays the following output:
//       ex1, ex1: 4 Methods, 0 Properties
//       ex2, ex2: 4 Methods, 0 Properties
//       ex3, : 0 Methods, 0 Properties

注釈

デリゲートは ConditionalWeakTable<TKey,TValue>.CreateValueCallback 、メソッドに渡されたキーが オブジェクトに見つからない場合にメソッドによって ConditionalWeakTable<TKey,TValue>.GetValue 呼び出されるコールバック メソッドを ConditionalWeakTable<TKey,TValue> カプセル化します。 メソッドは GetValue 、プロパティ値を動的にアタッチするマネージド オブジェクトを表すキーをコールバック メソッドに渡します。 メソッドは、プロパティ値を呼び出し元に返す役割を担います。これにより、キーと値のペアがテーブルに追加されます。

メソッドは ConditionalWeakTable<TKey,TValue>.CreateValueCallback 、指定したキーにアタッチできる参照型のインスタンスを返すために使用されます。 これにより、既定値以外の値を使用してインスタンスを初期化できます。 テーブルにキーが見つからない場合、 メソッドは、 ConditionalWeakTable<TKey,TValue>.GetOrCreateValue 値が既定値を使用して初期化されるキーと値のペアを追加します。

拡張メソッド

GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。

適用対象

こちらもご覧ください

• GetValue(TKey, ConditionalWeakTable<TKey,TValue>.CreateValueCallback)