XamlTypeInvoker.AddToDictionary(Object, Object, Object) Metode

Definisi

Ruang nama:

System.Xaml.Schema

Rakitan:

System.Xaml.dll

Menambahkan nilai kunci dan item yang disediakan ke instans jenis yang relevan dengan ini XamlTypeInvoker.

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)

Parameter

instance

Object

Instans jenis yang ditentukan oleh yang XamlType digunakan untuk membangun ini XamlTypeInvoker.

key

Object

Kunci kamus untuk item yang akan ditambahkan.

item

Object

Nilai item yang akan ditambahkan.

Pengecualian

NotSupportedException

Memanggil metode ini pada XamlTypeInvoker yang didasarkan pada yang tidak diketahui XamlType.

-atau-

Memanggil metode ini pada XamlTypeInvoker di mana jenis yang relevan bukan kamus.

ArgumentNullException

instanceadalah null.

XamlSchemaException

GetAddMethod(XamlType) untuk ini XamlTypeInvoker mengembalikan null.

Keterangan

Anda seharusnya hanya memanggil metode ini pada XamlType yang mewakili kamus.

Catatan Bagi Inheritor

Implementasi dasar mencakup panggilan ke pembantu ThrowIfUnknowninternal . Pembantu ini selalu melempar untuk kasus di mana XamlTypeInvoker didasarkan pada yang tidak diketahui XamlType, yang mencakup kasus di mana UnderlyingType dari XamlType adalah null.

Secara internal, implementasi dasar memanggil IsDictionary, dan melempar jika hasilnya adalah false.

Implementasi dasar tidak selalu menggunakan implementasinya sendiri GetAddMethod(XamlType) . Pertama, pemain instance untuk IDictionary dicoba. Jika ini berhasil, panggilan ke Add(Object, Object) dilakukan dan metode kembali. Jika tidak, implementasi dasar menggunakan CLR Invoke(Object, Object[]) untuk memanggil metode yang mendasar Add , seperti yang diperoleh dari panggilan ke GetAddMethod(XamlType) untuk ini XamlTypeInvoker.

Dalam implementasi dasar tidak ada pengecualian yang dinaikkan pada tingkat ini jika item atau key adalah null. Masih mungkin bahwa metode yang mendasar Add akan memunculkan pengecualian ketika dipanggil. Pengecualian run time lainnya dimungkinkan jika ItemType tidak mengembalikan hasil yang valid.