PersonalizationDictionary.Add(String, PersonalizationEntry) Metode

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Menambahkan entri personalisasi ke kamus personalisasi.

public:
 virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);

public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);

abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit

Public Overridable Sub Add (key As String, value As PersonalizationEntry)

Parameter

key

String

Pengidentifikasi unik untuk sepotong informasi status.

value

PersonalizationEntry

Bagian informasi status yang akan ditambahkan ke kamus personalisasi. Nilai ini bisa berupa null.

Pengecualian

ArgumentException

key adalah duplikat kunci yang sudah ada dalam kamus.

-atau-

key adalah string kosong ("") atau pemangkasan key menghasilkan string kosong.

-atau-

valuebukan .PersonalizationEntry

ArgumentNullException

keyadalah null.

-atau-

valueadalah null.

Keterangan

Anda dapat memanggil metode ini, menempatkan berbagai bagian informasi status kustom ke dalam objek status, dan menentukan cakupan yang terkait dengan nilai status. WebPartManager Saat kontrol berada dalam Shared cakupan, Anda dapat menambahkan informasi nama dan status yang terkait dengan Shared cakupan atau User cakupan. Dalam User cakupan, Anda dapat menambahkan informasi nama dan status yang hanya terkait dengan User cakupan.

Namun, ini adalah praktik yang baik untuk menambahkan semua properti ke kamus menggunakan Save termasuk properti dengan User atau Shared cakupan, terlepas dari cakupan halaman.

.NET Framework hanya menyimpan properti dengan Shared cakupan jika sesuai. Dengan kata lain, properti bersama tidak disimpan ketika WebPart kontrol yang awalnya ditambahkan dalam Shared cakupan kemudian disimpan saat halaman berada dalam User cakupan. Dalam skenario yang berlawanan, jika WebPart kontrol ditambahkan ke halaman dalam User cakupan, dan kontrol kemudian disimpan saat halaman berada dalam Shared cakupan, nilai properti bersama kustom disimpan (bersama dengan properti cakupan pengguna kustom). Untuk detail tentang data personalisasi dan bagaimana properti bersama dan cakupan pengguna dipengaruhi oleh cakupan personalisasi halaman, lihat topik Gambaran Umum Personalisasi Bagian Web .

Seperti halnya koleksi apa pun, metode ini meningkatkan jumlah koleksi satu per satu dan enumerator apa pun yang saat ini aktif pada koleksi harus tidak valid.

Lihat juga

• Gambaran Umum Personalisasi Bagian Web