WebPartManager.ImportWebPart(XmlReader, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee importeert u een XML-beschrijvingsbestand met status- en eigenschapsgegevens voor een WebPart besturingselement en past u de gegevens toe op het besturingselement.
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 WebPartParameters
- reader
- XmlReader
Een XmlReader bestand dat de status- en eigenschapsgegevens leest uit het XML-beschrijvingsbestand dat wordt geïmporteerd.
- errorMessage
- String
Een String die wordt weergegeven aan de gebruiker als er een fout optreedt tijdens het importeren.
Retouren
Een WebPart (of een serverbesturing die wordt verpakt door een GenericWebPart en dus behandeld als een WebPart) waarnaar wordt verwezen in het geïmporteerde XML-beschrijvingsbestand.
Uitzonderingen
reader is null.
reader kan het bestand niet lezen.
– of –
reader nodig om een importfoutbericht weer te geven, maar er is geen gevonden in het bestand.
– of –
reader het einde van het bestand bereikt zonder het XML-element te vinden dat de geëxporteerde gegevens bevat.
Opmerkingen
Met ImportWebPart de methode wordt een XML-beschrijvingsbestand geïmporteerd dat is gemaakt door de ExportWebPart methode voor een serverbeheer. Het is niet het daadwerkelijke serverbesturingselement dat wordt geïmporteerd, maar alleen het beschrijvingsbestand met status- en eigenschapsgegevens over het besturingselement. Het besturingselement en de assembly waarnaar in het beschrijvingsbestand wordt verwezen, moeten al beschikbaar zijn op de server waarop een gebruiker probeert het beschrijvingsbestand te importeren.
Als u het importeren van een besturingselement wilt inschakelen, moet een ontwikkelaar een CatalogZone besturingselement toevoegen op de pagina waar importeren wordt ingeschakeld. Binnen de zone moet een ImportCatalogPart besturingselement worden toegevoegd. Dit besturingselement bevat een dialoogvenster met bestanden waarmee gebruikers kunnen bladeren en zoeken naar het beschrijvingsbestand dat moet worden geïmporteerd.
Nadat een gebruiker een beschrijvingsbestand heeft gevonden en het importeren begint, wordt het beschrijvingsbestand gelezen door de ImportWebPart methode. Als er geen fouten zijn en als de assembly en het besturingselement worden gevonden, wordt het serverbesturingselement toegevoegd aan de catalogus binnen het ImportCatalogPart besturingselement en worden de verschillende eigenschaps- en statusgegevens die zijn opgegeven in het beschrijvingsbestand toegepast op het besturingselement. De gebruiker kan vervolgens het besturingselement selecteren en toevoegen aan de pagina.
Important
Net als bij de ExportWebPart methode heeft de ImportWebPart methode enige kans op beveiligingsrisico's. Omdat het gaat om het importeren van gegevens in een website, kan een kwaadwillende gebruiker proberen ongeldige gegevens of zelfs scriptcode in te voegen in het beschrijvingsbestand dat wordt geïmporteerd. Vervolgens kunnen de slechte gegevens worden weergegeven op een pagina of in een database, of het ingevoegde script kan worden uitgevoerd. Zie Pagina's met webonderdelen beveiligen voor een overzicht van de mogelijke risico's die zijn verbonden aan het importeren van beschrijvingsbestanden en manieren om deze risico's te voorkomen.
