WebPartManager.ExportWebPart(WebPart, XmlWriter) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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 -> unit
Public 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

ArgumentNullException

webPart ist null.

- oder -

writer ist null.

ArgumentException

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.

Gilt für:

Weitere Informationen