XamlTypeInvoker.AddToDictionary(Object, Object, Object) Yöntem

Tanım

Ad Alanı:

System.Xaml.Schema

Bütünleştirilmiş Kod:

System.Xaml.dll

Sağlanan anahtar ve öğe değerini, türün bu XamlTypeInvokerile ilgili bir örneğine ekler.

public:
 virtual void AddToDictionary(System::Object ^ instance, System::Object ^ key, System::Object ^ item);

public virtual void AddToDictionary (object instance, object key, object item);

abstract member AddToDictionary : obj * obj * obj -> unit
override this.AddToDictionary : obj * obj * obj -> unit

Public Overridable Sub AddToDictionary (instance As Object, key As Object, item As Object)

Parametreler

instance

Object

Bu XamlTypeInvokeroluşturmak için kullanılan tarafından XamlType belirtilen türün bir örneği.

key

Object

Eklenecek öğenin sözlük anahtarı.

item

Object

Eklenecek öğe değeri.

Özel durumlar

NotSupportedException

Bilinmeyen bir tabanlı XamlTypebir XamlTypeInvoker üzerinde bu yöntemi çağırıldı.

-Veya-

İlgili türün sözlük olmadığı bir XamlTypeInvoker yerde bu yöntem çağrıldı.

ArgumentNullException

instance, null değeridir.

XamlSchemaException

GetAddMethod(XamlType) için XamlTypeInvoker döndürür null.

Açıklamalar

Bu yöntemi yalnızca sözlüğü temsil eden bir XamlType üzerinde çağırmalısınız.

Devralanlara Notlar

Temel uygulama, iç yardımcıya ThrowIfUnknownbir çağrı içerir. Bu yardımcı, öğesinin XamlTypeInvoker olduğu durumları içeren bilinmeyen XamlTypebir öğesini temel aldığı durumlar UnderlyingTypeXamlTypenulliçin her zaman oluşturur.

Dahili olarak, temel uygulama çağrıları IsDictionaryve sonucu falseise oluşturur.

Temel uygulama kendi GetAddMethod(XamlType) uygulamasını mutlaka kullanmaz. İlk olarak, öğesinin ataması instanceIDictionary denendi. Bu başarılı olursa, çağrısı Add(Object, Object) yapılır ve yöntemi döner. Aksi takdirde temel uygulama, bu XamlTypeInvokeriçin çağrısından elde edilen temel Add yöntemi çağırmak GetAddMethod(XamlType) için CLR Invoke(Object, Object[]) kullanır.

Temel uygulamada, veya key ise item bu düzeyde hiçbir özel durum tetiklenmiş değildirnull. Temel alınan Add yöntemin çağrıldığında bir özel durum oluşturması yine de mümkündür. Geçerli bir sonuç döndürmezse ItemType diğer çalışma zamanı özel durumları mümkündür.