WebPartManager.ExportWebPart(WebPart, XmlWriter) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat file deskripsi XML yang berisi data status dan properti untuk kontrol server.
public:
virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);public virtual void ExportWebPart(System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)Parameter
- webPart
- WebPart
Kontrol tempat data akan diekspor.
Pengecualian
webPart tidak terkandung dalam kumpulan kontrol yang direferensikan dalam Controls.
-atau-
ExportMode Properti diatur webPart ke nilai None, yang berarti bahwa ekspor dinonaktifkan untuk webPart.
Keterangan
Metode ini ExportWebPart merakitan berbagai data status dan properti dari webPart ke dalam file XML. Data mencakup informasi tentang kontrol itu sendiri, termasuk perakitannya, data status, dan data propertinya. Pengguna yang memulai ekspor dapat menyimpan file XML ke disk di komputer lokal atau jaringan. Pengguna lain kemudian dapat mengimpor file deskripsi ke halaman atau situs Web yang berbeda, dan menerapkan data status dan properti ke instans yang berbeda dari webPart. Ini menyediakan mekanisme yang cepat dan nyaman bagi pengguna untuk berbagi dan menggunakan kembali pengaturan mereka pada kontrol server, dan juga memberi pengembang sarana untuk mengontrol tampilan dan perilaku kontrol yang diekspor dan diimpor.
Properti pada tidak diekspor webPart secara default. Untuk mengaktifkan ekspor properti, Anda harus menandainya dengan [Personalizable] atribut dalam kode sumber. Anda juga dapat secara opsional menandai properti yang dapat diekspor sebagai berisi data sensitif, dengan mengatur isSensitive parameter [Personalizable] atribut ke true. Secara default, isSensitive adalah false. Pengembang dapat mengatur parameter ke true untuk menunjukkan bahwa data sensitif.
Untuk memungkinkan webPart diekspor, pengembang menetapkan nilai propertinya ExportMode ke ( All yang mencakup semua properti yang dapat dipersonalisasi dan sensitif), atau ke NonSensitiveData, yang mengekspor semuanya kecuali untuk properti sensitif.
Penting
Memungkinkan pengguna mengekspor data dari kontrol, dan mengimpor data ke kontrol lain, memerlukan beberapa risiko keamanan. Pengembang harus menggunakan pendekatan yang dibahas di atas untuk melindungi data sensitif, dan jika mereka ingin menghindari risiko mengekspos data sama sekali, mereka tidak boleh mengaktifkan ekspor webPart sama sekali. Untuk detail tentang masalah keamanan Komponen Web, lihat Mengamankan Halaman Komponen Web.
