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 Zustands- und Eigenschaftendaten 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, dessen Daten exportiert werden.
- writer
- XmlWriter
Ein XmlWriter, der die exportierten Daten von webPart in eine XML-Beschreibungsdatei schreibt.
Ausnahmen
webPart ist nicht in der Auflistung von Steuerelementen enthalten, auf die in Controls verwiesen wird.
- oder -
Die ExportMode-Eigenschaft von webPart ist auf den Wert None festgelegt. Dies bedeutet, dass der Export für webPart deaktiviert ist.
Hinweise
Die ExportWebPart Methode sammelt verschiedene Zustands- und Eigenschaftsdaten aus webPart einer XML-Datei. Die Daten enthalten Informationen zum Steuerelement selbst, einschließlich seiner Assembly, Zustandsdaten und Eigenschaftendaten. Der Benutzer, der den Export initiiert, kann die XML-Datei auf dem lokalen Computer oder im Netzwerk speichern. Andere Benutzer können dann die Beschreibungsdatei auf eine andere Seite oder Website importieren und die Zustands- und Eigenschaftsdaten auf eine andere Instanz von webPartanwenden. Dies bietet benutzern einen schnellen und bequemen Mechanismus zum Freigeben und Wiederverwenden ihrer Einstellungen für Serversteuerelemente und bietet Entwicklern außerdem eine Möglichkeit, die Darstellung und das Verhalten exportierter und importierter Steuerelemente zu steuern.
Eigenschaften für webPart werden 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 mit vertraulichen Daten kennzeichnen, indem Sie den isSensitive Parameter des [Personalizable] Attributs auf truefestlegen.
isSensitive ist standardmäßig false. Entwickler können den Parameter auf true festlegen, um anzugeben, dass die Daten vertraulich sind.
Um den Export zu ermöglichen webPart , legt ein Entwickler seinen ExportMode Eigenschaftswert auf entweder All (einschließlich aller personalisierbaren und vertraulichen Eigenschaften) oder auf fest NonSensitiveData, der alles mit Ausnahme vertraulicher Eigenschaften exportiert.
Wichtig
Das Zulassen, dass Benutzer Daten aus Steuerelementen exportieren und Daten in andere Steuerelemente importieren können, ist mit einigen Sicherheitsrisiken verbunden. Entwickler sollten den oben beschriebenen Ansatz verwenden, um vertrauliche Daten zu schützen, und wenn sie das Risiko einer vollständigen Offenlegung von Daten vermeiden möchten, sollten sie den Export webPart überhaupt nicht aktivieren. Ausführliche Informationen zu Webparts-Sicherheitsproblemen finden Sie unter Schützen von Webparts-Seiten.
