WebPart.SetPersonalizationDirty Metode

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Mengatur bendera yang menunjukkan bahwa data personalisasi telah berubah untuk kontrol Bagian Web atau kontrol server yang ditempatkan di WebPartZoneBase zona.

Overload

SetPersonalizationDirty(Control)	Mengatur bendera yang menunjukkan bahwa data personalisasi telah berubah untuk kontrol server yang ditentukan yang berada di WebPartZoneBase zona.
SetPersonalizationDirty()	Mengatur bendera yang menunjukkan bahwa data personalisasi telah berubah untuk instans kontrol saat ini WebPart .

SetPersonalizationDirty(Control)

Mengatur bendera yang menunjukkan bahwa data personalisasi telah berubah untuk kontrol server yang ditentukan yang berada di WebPartZoneBase zona.

public:
 static void SetPersonalizationDirty(System::Web::UI::Control ^ control);

public static void SetPersonalizationDirty (System.Web.UI.Control control);

static member SetPersonalizationDirty : System.Web.UI.Control -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

Parameter

control

Control

yang Control data personalisasinya telah berubah.

Pengecualian

ArgumentNullException

Objek dalam control parameter adalah null.

ArgumentException

Kontrol tidak terkait dengan halaman.

-atau-

Kontrol berasal dari WebPart. Kontrol yang berasal dari WebPart harus menggunakan metode yang dilindungi SetPersonalizationDirty() sebagai gantinya.

InvalidOperationException

Halaman yang terkait dengan kontrol tidak memiliki WebPartManager.

Keterangan

Metode WebPart.SetPersonalizationDirty ini memiliki tujuan yang sama dengan WebPart.SetPersonalizationDirty() metode , yaitu untuk mengatur bendera yang menunjukkan bahwa data status kontrol telah diubah (dipersonalisasi) pada kontrol server selama permintaan HTTP GET . Perbedaan antara metode ini adalah bahwa WebPart.SetPersonalizationDirty metode digunakan untuk kontrol server yang tidak mewarisi dari WebPart kelas, tetapi ditempatkan dalam WebPartZoneBase zona untuk berpartisipasi dalam aplikasi Bagian Web.

Lihat juga

• ASP.NET Kontrol Komponen Web

SetPersonalizationDirty()

Mengatur bendera yang menunjukkan bahwa data personalisasi telah berubah untuk instans kontrol saat ini WebPart .

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

Pengecualian

InvalidOperationException

WebPartManageradalah null.

Keterangan

Metode ini SetPersonalizationDirty menetapkan bendera yang menunjukkan bahwa data status kontrol telah diubah (dipersonalisasi) pada WebPart kontrol, dan oleh karena itu WebPartManager kontrol perlu mempertahankan data personalisasi ke penyimpanan jangka panjang.

WebPartManager Biasanya personalisasi terus berubah pada WebPart kontrol tanpa perlu pengembang untuk memanggil metode .SetPersonalizationDirty Tetapi ada dua kasus di mana pengembang perlu memanggil metode ini. Kasus pertama adalah ketika data status kontrol diubah selama permintaan HTTP GET ke halaman. Secara default, perubahan pada data status kontrol selama GET permintaan tidak dipertahankan (untuk tujuan keamanan). Tetapi metode ini SetPersonalizationDirty menyediakan cara untuk mempertahankan perubahan personalisasi yang sah untuk WebPart kontrol dalam kasus ini.

Kasus kedua untuk memanggil SetPersonalizationDirty metode terjadi selama permintaan HTTP POST ke halaman. WebPart Jika kontrol memiliki properti kompleks yang dapat dipersonalisasi (seperti properti yang berisi ArrayList objek), dan data status kontrol di properti tersebut dipersonalisasi selama POST permintaan, pengembang harus memanggil SetPersonalizationDirty metode untuk memastikan bahwa perubahan tetap ada.

Lihat juga

• ASP.NET Kontrol Komponen Web