ConditionalWeakTable<TKey,TValue>.Add(TKey, TValue) Método

Definición

Espacio de nombres:

System.Runtime.CompilerServices

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

ConditionalWeakTable.cs

Agrega una clave a la tabla.

C#

public void Add(TKey key, TValue value);

Parámetros

key

TKey

Clave que se va a agregar. key representa el objeto al que se adjunta la propiedad.

value

TValue

Valor de propiedad de la clave.

Excepciones

ArgumentNullException

key es null.

ArgumentException

key ya existe.

Ejemplos

En el ejemplo siguiente se define una MainClass clase y una MainInfo clase , que proporciona información sobre la MainClass instancia de . A continuación, el ejemplo llama al Add método para agregar un MainClass objeto y su objeto adjunto MainInfo a una ConditionalWeakTable<TKey,TValue> tabla. En el ejemplo también se muestran las llamadas a los GetOrCreateValue métodos y GetValue para agregar pares clave-valor a la tabla y al TryGetValue método para recuperar el valor de una clave existente.

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

Comentarios

Cada clave de un ConditionalWeakTable<TKey,TValue> objeto debe ser única. Las claves no son únicas si hacen referencia al mismo objeto (es decir, si se pasan como argumentos al Object.ReferenceEquals método devuelve true).

Si la clave se recopila como elemento no utilizado durante la operación de suma, se quita el par clave-valor existente y se agrega el nuevo par clave-valor sin que se produzca una excepción.

Se aplica a

Consulte también

• GetOrCreateValue(TKey)