WebPartManager.ExportWebPart(WebPart, XmlWriter) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Sunucu denetimi için durum ve özellik verilerini içeren bir XML açıklama dosyası oluşturur.
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)Parametreler
- webPart
- WebPart
Verilerin dışarı aktarılacağı denetim.
Özel durumlar
webPart içinde başvuruda bulunılan denetimler koleksiyonunda yer almaz Controls.
-veya-
ExportMode özelliği webPart değerine ayarlanır Noneve bu da dışarı aktarma işleminin için webPartdevre dışı bırakıldığı anlamına gelir.
Açıklamalar
yöntemi, ExportWebPart çeşitli webPart durum ve özellik verilerini bir XML dosyasına birleştirir. Veriler, derleme, durum verileri ve özellik verileri dahil olmak üzere denetimin kendisi hakkında bilgiler içerir. Dışarı aktarmayı başlatan kullanıcı, XML dosyasını yerel bilgisayardaki veya ağdaki diske kaydedebilir. Diğer kullanıcılar daha sonra açıklama dosyasını farklı bir sayfaya veya Web sitesine aktarabilir ve durum ve özellik verilerini farklı bir örneğine webPartuygulayabilir. Bu, kullanıcıların ayarlarını sunucu denetimlerinde paylaşmaları ve yeniden kullanmaları için hızlı ve kullanışlı bir mekanizma sağlar ve ayrıca geliştiricilere dışarı ve içeri aktarılan denetimlerin görünümünü ve davranışını denetlemek için bir araç sağlar.
üzerindeki webPart özellikler varsayılan olarak dışarı aktarılmaz. Bir özelliğin dışarı aktarmasını etkinleştirmek için, bunu kaynak koddaki özniteliğiyle [Personalizable] işaretlemeniz gerekir. Ayrıca isteğe bağlı olarak, özniteliğinin trueparametresini [Personalizable] olarak ayarlayarak isSensitive dışarı aktarılabilir bir özelliği hassas veriler içeriyor olarak işaretleyebilirsiniz. Varsayılan olarak, isSensitivefalseolarak kabul edilir. Geliştiriciler, verilerin hassas olduğunu belirtmek için parametresini true olarak ayarlayabilir.
Dışarı aktarmayı etkinleştirmek webPart için, geliştirici özellik değerini All (tüm kişiselleştirilebilir ve hassas özellikleri içerir) veya NonSensitiveDatahassas özellikler dışındaki her şeyi dışarı aktaran olarak ayarlarExportMode.
Önemli
Kullanıcıların denetimlerden verileri dışarı aktarmasına ve verileri diğer denetimlere aktarmasına izin vermek bazı güvenlik risklerini kapsar. Geliştiriciler hassas verileri korumak için yukarıda açıklanan yaklaşımı kullanmalıdır ve verileri tamamen açığa çıkarma riskini önlemek istediklerinde dışarı aktarmayı webPart hiç etkinleştirmemeleri gerekir. Web Bölümleri güvenlik sorunlarıyla ilgili ayrıntılar için bkz. Web Bölümleri Sayfalarının Güvenliğini Sağlama.
