WebPartManager.ExportWebPart(WebPart, XmlWriter) Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

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 -> unit

Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

Parametreler

webPart

WebPart

Verilerin dışarı aktarılacağı denetim.

writer

XmlWriter

XmlWriter Dışarı aktarılan verileri webPart bir XML açıklama dosyasına yazan bir.

Özel durumlar

ArgumentNullException

webPart, null değeridir.

-veya-

writer, null değeridir.

ArgumentException

webPart içinde başvuruda bulunılan denetimler koleksiyonunda yer almaz Controls.

-veya-

ExportMode özelliği webPart değeri olarak ayarlanırNone; bu da için webPartdışarı aktarmanın devre 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 de 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. Daha sonra diğer kullanıcılar 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 sunucu denetimlerinde ayarlarını 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 kaynak kodunda [Personalizable] özniteliğiyle işaretlemeniz gerekir. Ayrıca, özniteliğinin trueparametresini [Personalizable] olarak ayarlayarak isSensitive isteğe bağlı olarak dışarı aktarılabilir bir özelliği hassas veriler içeriyor olarak işaretleyebilirsiniz. Varsayılan olarak, isSensitive şeklindedir false. Geliştiriciler, verilerin hassas olduğunu belirtmek için true parametresini olarak ayarlayabilir.

Dışarı aktarılmayı etkinleştirmek webPart için, geliştirici özellik değerini All (tüm kişiselleştirilebilir ve hassas özellikleri içeren) veya NonSensitiveDatahassas özellikler dışında 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 risklerine neden olur. Geliştiriciler, hassas verileri korumak için yukarıda açıklanan yaklaşımı kullanmalı ve verileri tamamen açığa çıkarma riskini önlemek istiyorlarsa, dışarı aktarmayı webPart hiç etkinleştirmemelidir. 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.

Ayrıca bkz.

• ExportMode
• ImportWebPart(XmlReader, String)
• Web Bölümleri Sayfalarının Güvenliğini Sağlama