WebPartManager.ImportWebPart(XmlReader, String) 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.
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
İç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
reader
, null
değeridir.
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.