WebPartManager.ImportWebPart(XmlReader, String) Yöntem

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Bir denetimin durum ve özellik verilerini içeren bir WebPart XML açıklama dosyasını içeri aktarır ve verileri denetime uygular.

public:
 virtual System::Web::UI::WebControls::WebParts::WebPart ^ ImportWebPart(System::Xml::XmlReader ^ reader, [Runtime::InteropServices::Out] System::String ^ % errorMessage);

public virtual System.Web.UI.WebControls.WebParts.WebPart ImportWebPart (System.Xml.XmlReader reader, out string errorMessage);

abstract member ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart
override this.ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart

Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

Parametreler

reader

XmlReader

XmlReader İçeri aktarılan XML açıklama dosyasından durum ve özellik verilerini okuyan bir.

errorMessage

String

String İçeri aktarma sırasında bir hatayla karşılaşılırsa kullanıcıya görüntülenen bir.

Döndürülenler

WebPart

İçeri WebPart aktarılan XML açıklama dosyasında başvurulan bir (veya bir GenericWebPart tarafından sarmalanan ve bu nedenle bir olarak kabul edilen bir WebPartsunucu denetimi).

Özel durumlar

ArgumentNullException

reader, null değeridir.

EndOfStreamException

reader dosyayı okuyamadı.

-veya-

reader bir içeri aktarma hata iletisini görüntülemek için gerekli ancak dosyada bulamadım.

-veya-

reader , dışarı aktarılan verileri içeren XML öğesini bulmadan dosyanın sonuna ulaştı.

Açıklamalar

yöntemi, ImportWebPart bir sunucu denetimi yöntemi tarafından ExportWebPart oluşturulan bir XML açıklama dosyasını içeri aktarır. İçeri aktarılan gerçek sunucu denetimi değil, yalnızca denetimle ilgili durum ve özellik verilerini içeren açıklama dosyasıdır. Açıklama dosyasında başvuruda bulunulan denetim ve derleme, kullanıcının açıklama dosyasını içeri aktarmaya çalıştığı sunucuda zaten kullanılabilir olmalıdır.

Denetimi içeri aktarmayı etkinleştirmek için geliştiricinin içeri aktarmanın etkinleştirileceği sayfaya bir CatalogZone denetim eklemesi gerekir. Bölge içinde bir ImportCatalogPart denetim eklenmelidir. Bu denetim, kullanıcıların içeri aktaracak açıklama dosyasına göz atmasını ve bu dosyayı bulmasını sağlayan bir dosya iletişim kutusu sağlar.

Kullanıcı bir açıklama dosyası bulup içeri aktarmayı başladıktan sonra, açıklama dosyası yöntemi tarafından ImportWebPart okunur. Hata yoksa ve derleme ve denetim bulunursa, sunucu denetimi denetim içindeki ImportCatalogPart kataloğa eklenir ve açıklama dosyasında belirtilen çeşitli özellik ve durum verileri denetime uygulanır. Kullanıcı daha sonra denetimi seçip sayfaya ekleyebilir.

Önemli

yönteminde ExportWebPart olduğu gibi, yöntemin ImportWebPart de güvenlik riskleri için bazı olasılıkları vardır. Bir Web sitesine veri aktarmayı içerdiğinden, kötü amaçlı bir kullanıcı içeri aktarılan açıklama dosyasına hatalı veri veya hatta betik kodu eklemeyi deneyebilir. Daha sonra hatalı veriler bir sayfada veya veritabanında görünebilir ya da eklenen betik çalıştırılabilir. Açıklama dosyalarını içeri aktarmayla ilgili olası risklere ve bu risklerden kaçınmanın yollarına genel bakış için bkz. Web Bölümleri Sayfalarının Güvenliğini Sağlama.

Ayrıca bkz.

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• Web Bölümleri Sayfalarının Güvenliğini Sağlama