WebPartManager.ExportWebPart(WebPart, XmlWriter) 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 maakt u een XML-beschrijvingsbestand met status- en eigenschapsgegevens voor een serverbesturingselement.
public:
virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);public virtual void ExportWebPart(System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)Parameters
- webPart
- WebPart
Het besturingselement waaruit gegevens worden geëxporteerd.
- writer
- XmlWriter
Een XmlWriter bestand dat de geëxporteerde gegevens webPart naar een XML-beschrijvingsbestand schrijft.
Uitzonderingen
webPart is niet opgenomen in de verzameling besturingselementen waarnaar wordt verwezen in Controls.
– of –
De ExportMode eigenschap webPart is ingesteld op een waarde van None, wat betekent dat export is uitgeschakeld voor webPart.
Opmerkingen
De ExportWebPart methode verzamelt verschillende status- en eigenschapsgegevens uit webPart in een XML-bestand. De gegevens bevatten informatie over het besturingselement zelf, met inbegrip van de assembly-, statusgegevens en eigenschapsgegevens. De gebruiker die de export initieert, kan het XML-bestand opslaan op schijf op de lokale computer of het netwerk. Andere gebruikers kunnen het beschrijvingsbestand vervolgens importeren naar een andere pagina of website en de status- en eigenschapsgegevens toepassen op een ander exemplaar van webPart. Dit biedt een snel en handig mechanisme voor gebruikers om hun instellingen op serverbesturingselementen te delen en opnieuw te gebruiken, en biedt ontwikkelaars ook een manier om het uiterlijk en gedrag van geëxporteerde en geïmporteerde besturingselementen te beheren.
webPart Eigenschappen op worden niet standaard geëxporteerd. Als u het exporteren van een eigenschap wilt inschakelen, moet u deze markeren met het [Personalizable] kenmerk in de broncode. U kunt desgewenst ook een exportbare eigenschap markeren als met gevoelige gegevens door de isSensitive parameter van het [Personalizable] kenmerk in te stellen op true. Standaard is isSensitivefalse. Ontwikkelaars kunnen de parameter instellen om true aan te geven dat de gegevens gevoelig zijn.
Om te webPart kunnen worden geëxporteerd, stelt een ontwikkelaar de ExportMode eigenschapswaarde in op All (inclusief alle persoonlijke en gevoelige eigenschappen) of op NonSensitiveData, waarmee alles wordt geëxporteerd, met uitzondering van gevoelige eigenschappen.
Important
Gebruikers toestaan om gegevens uit besturingselementen te exporteren en gegevens in andere besturingselementen te importeren, brengen enkele beveiligingsrisico's met zich mee. Ontwikkelaars moeten de hierboven besproken benadering gebruiken om gevoelige gegevens te beveiligen en als ze het risico van het blootstellen van gegevens helemaal willen voorkomen, moeten ze het exporteren webPart helemaal niet inschakelen. Zie Pagina's met webonderdelen beveiligen voor meer informatie over beveiligingsproblemen met webonderdelen.