WebPartManager.ImportWebPart(XmlReader, String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Importuje plik opisu XML, który zawiera dane o stanie i właściwości dla WebPart kontrolki, i stosuje dane do kontrolki.

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

Parametry

reader: XmlReader

Element XmlReader odczytujący dane o stanie i właściwości z importowanego pliku opisu XML.

errorMessage: String

Element String , który jest wyświetlany użytkownikowi w przypadku wystąpienia błędu podczas importowania.

Zwraca

WebPart

A WebPart (lub kontrolka serwera, która jest owinięta przez GenericWebPart element i w ten sposób traktowany WebPartjako ) , do którego odwołuje się importowany plik opisu XML.

Wyjątki

ArgumentNullException

reader to null.

EndOfStreamException

reader Program nie może odczytać pliku.

-lub-

reader wymagane do wyświetlenia komunikatu o błędzie importu, ale nie znaleziono go w pliku.

-lub-

reader osiągnięto koniec pliku bez znajdowania elementu XML zawierającego wyeksportowane dane.

Uwagi

Metoda ImportWebPart importuje plik opisu XML, który został utworzony przez ExportWebPart metodę dla kontrolki serwera. Nie jest to rzeczywista kontrolka serwera, która jest importowana, ale tylko plik opisu zawierający dane o stanie i właściwości dotyczące kontrolki. Kontrolka i zestaw, do którego odwołuje się plik opisu, muszą być już dostępne na serwerze, na którym użytkownik próbuje zaimportować plik opisu.

Aby umożliwić importowanie kontrolki, deweloper musi dodać kontrolkę CatalogZone na stronie, na której zostanie włączony import. W strefie należy dodać kontrolkę ImportCatalogPart . Ta kontrolka udostępnia okno dialogowe pliku, które umożliwia użytkownikom przeglądanie i lokalizowanie pliku opisu do zaimportowania.

Gdy użytkownik znajdzie plik opisu i rozpocznie importowanie, plik opisu jest odczytywany przez metodę ImportWebPart . Jeśli nie ma żadnych błędów, a zestaw i kontrolka zostaną znalezione, kontrolka serwera zostanie dodana do wykazu w ImportCatalogPart kontrolce, a do kontrolki zostaną zastosowane różne dane właściwości i stanu określone w pliku opisu. Następnie użytkownik może wybrać kontrolkę i dodać ją do strony.

Ważne

Podobnie jak metoda ExportWebPart , ImportWebPart metoda ma pewien potencjał dla zagrożeń bezpieczeństwa. Ponieważ obejmuje importowanie danych do witryny sieci Web, złośliwy użytkownik może spróbować wstawić nieprawidłowe dane, a nawet kod skryptu do zaimportowanego pliku opisu. Następnie na stronie lub w bazie danych mogą pojawić się nieprawidłowe dane albo może zostać uruchomiony wstawiony skrypt. Aby zapoznać się z omówieniem potencjalnych zagrożeń związanych z importowaniem plików opisu i sposobami unikania tych zagrożeń, zobacz Zabezpieczanie stron składników Web Part.

Dotyczy

Share via