WebPartManager.ImportWebPart(XmlReader, String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Importerar en XML-beskrivningsfil som innehåller tillstånds- och egenskapsdata för en WebPart kontroll och tillämpar data på kontrollen.
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.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPartParametrar
- reader
- XmlReader
En XmlReader som läser tillstånds- och egenskapsdata från XML-beskrivningsfilen som importeras.
Returer
En WebPart (eller en serverkontroll som omsluts av en GenericWebPart och därmed behandlas som en WebPart) som refereras till i den importerade XML-beskrivningsfilen.
Undantag
reader är null.
reader kunde inte läsa filen.
-eller-
reader behövdes för att visa ett importfelmeddelande men hittade inget i filen.
-eller-
reader nådde slutet av filen utan att hitta XML-elementet som innehåller exporterade data.
Kommentarer
Metoden ImportWebPart importerar en XML-beskrivningsfil som skapades av ExportWebPart metoden för en serverkontroll. Det är inte den faktiska serverkontrollen som importeras, utan bara beskrivningsfilen som innehåller tillstånds- och egenskapsdata om kontrollen. Kontrollen och sammansättningen som refereras till i beskrivningsfilen måste redan vara tillgängliga på servern där en användare försöker importera beskrivningsfilen.
För att kunna importera en kontroll måste en utvecklare lägga till en CatalogZone kontroll på sidan där importen ska aktiveras. I zonen måste en ImportCatalogPart kontroll läggas till. Den här kontrollen innehåller en fildialogruta där användarna kan bläddra och leta upp beskrivningsfilen som ska importeras.
När en användare hittar en beskrivningsfil och påbörjar importen läss beskrivningsfilen av ImportWebPart metoden . Om det inte finns några fel och om sammansättningen och kontrollen hittas läggs serverkontrollen till i katalogen i ImportCatalogPart kontrollen och de olika egenskaps- och tillståndsdata som anges i beskrivningsfilen tillämpas på kontrollen. Användaren kan sedan välja kontrollen och lägga till den på sidan.
Important
Precis som ExportWebPart metoden ImportWebPart har metoden viss potential för säkerhetsrisker. Eftersom det handlar om att importera data till en webbplats kan en obehörig användare försöka infoga felaktiga data eller till och med skriptkod i beskrivningsfilen som importeras. Då kan felaktiga data visas på en sida eller i en databas, eller så kan det infogade skriptet köras. En översikt över potentiella risker som är kopplade till import av beskrivningsfiler och sätt att undvika dessa risker finns i Skydda webbsidor.
