WebPartManager.ExportWebPart(WebPart, XmlWriter) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine XML-Beschreibungsdatei, die Status- und Eigenschaftsdaten für ein Serversteuerelement enthält.
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)Parameter
- webPart
- WebPart
Das Steuerelement, aus dem Daten exportiert werden.
- writer
- XmlWriter
Eine XmlWriter Datei, die die exportierten Daten in webPart eine XML-Beschreibungsdatei schreibt.
Ausnahmen
webPart ist nicht in der Auflistung von Steuerelementen enthalten, auf Controlsdie verwiesen wird.
- oder -
Die ExportMode Eigenschaft von webPart ist auf einen Wert von Nonefestgelegt, was bedeutet, dass der Export für webPartdeaktiviert ist.
Hinweise
Die ExportWebPart Methode fasst verschiedene Zustands- und Eigenschaftsdaten aus webPart einer XML-Datei zusammen. Die Daten enthalten Informationen zum Steuerelement selbst, einschließlich der Assembly-, Zustands- und Eigenschaftendaten. Der Benutzer, der den Export initiiert, kann die XML-Datei auf dem Datenträger auf dem lokalen Computer oder im Netzwerk speichern. Andere Benutzer können dann die Beschreibungsdatei auf eine andere Seite oder Website importieren und die Status- und Eigenschaftsdaten auf eine andere Instanz von webPartanwenden. Dies bietet einen schnellen und bequemen Mechanismus, mit dem Benutzer ihre Einstellungen auf Serversteuerelementen freigeben und wiederverwenden können, und es bietet Entwicklern außerdem eine Möglichkeit, das Erscheinungsbild und Verhalten exportierter und importierter Steuerelemente zu steuern.
Eigenschaften werden webPart standardmäßig nicht exportiert. Um den Export einer Eigenschaft zu aktivieren, müssen Sie sie mit dem [Personalizable] Attribut im Quellcode markieren. Optional können Sie eine exportierbare Eigenschaft auch als vertrauliche Daten markieren, indem Sie den isSensitive Parameter des [Personalizable] Attributs auf truefestlegen. Standardmäßig ist isSensitivefalse. Entwickler können den Parameter true so festlegen, dass er angibt, dass die Daten vertraulich sind.
Um den Export zu ermöglichen webPart , legt ein Entwickler seinen ExportMode Eigenschaftswert entweder All auf (einschließlich aller personalisierbaren und vertraulichen Eigenschaften) oder auf , in NonSensitiveDatadas alles mit Ausnahme vertraulicher Eigenschaften exportiert wird.
Von Bedeutung
Benutzer können Daten aus Steuerelementen exportieren und Daten in andere Steuerelemente importieren, was einige Sicherheitsrisiken mit sich bringt. Entwickler sollten den oben beschriebenen Ansatz verwenden, um vertrauliche Daten zu schützen, und wenn sie das Risiko vermeiden möchten, Daten vollständig verfügbar zu machen, sollten sie den Export webPart überhaupt nicht aktivieren. Ausführliche Informationen zu Sicherheitsproblemen von Webparts finden Sie unter Schützen von Webparts-Seiten.
