WebPartManager.ImportWebPart(XmlReader, String) Methode

  • Referenz

Definition

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

Importiert eine XML-Beschreibungsdatei, die Zustands- und Eigenschaftendaten für ein WebPart-Steuerelement enthält, und wendet die Daten auf das Steuerelement an.

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.WebPart
Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

Parameter

reader
XmlReader

Ein XmlReader, der die Zustands- und Eigenschaftendaten aus der zu importierenden XML-Beschreibungsdatei liest.

errorMessage
String

Ein String, der angezeigt wird, wenn während des Imports ein Fehler auftritt.

Gibt zurück

WebPart

Ein WebPart-Steuerelement (oder ein Serversteuerelement, das mit einem GenericWebPart umschlossen ist und daher als WebPart behandelt wird), auf das in der importierten XML-Beschreibungsdatei verwiesen wird.

Ausnahmen

ArgumentNullException

reader ist null.

EndOfStreamException

reader konnte die Datei nicht lesen.

- oder -

reader hätte eine Importfehlermeldung anzeigen müssen, fand aber in der Datei keine entsprechende Meldung.

- oder -

reader hat das Ende der Datei erreicht, ohne das XML-Element gefunden zu haben, das die exportierten Daten enthält.

Hinweise

Die ImportWebPart -Methode importiert eine XML-Beschreibungsdatei, die von der ExportWebPart -Methode für ein Serversteuerelement erstellt wurde. Es wird nicht das eigentliche Serversteuerelement importiert, sondern nur die Beschreibungsdatei, die Zustands- und Eigenschaftsdaten zum Steuerelement enthält. Das Steuerelement und die Assembly, auf die in der Beschreibungsdatei verwiesen wird, müssen bereits auf dem Server verfügbar sein, auf den ein Benutzer versucht, die Beschreibungsdatei zu importieren.

Um den Import eines Steuerelements zu aktivieren, muss ein Entwickler ein CatalogZone Steuerelement auf der Seite hinzufügen, auf der der Import aktiviert wird. Innerhalb der Zone muss ein ImportCatalogPart Steuerelement hinzugefügt werden. Dieses Steuerelement bietet ein Dateidialogfeld, mit dem Benutzer die zu importierende Beschreibungsdatei durchsuchen und suchen können.

Nachdem ein Benutzer eine Beschreibungsdatei gefunden hat und mit dem Import beginnt, wird die Beschreibungsdatei von der ImportWebPart -Methode gelesen. Wenn keine Fehler auftreten und die Assembly und das Steuerelement gefunden werden, wird das Serversteuerelement dem Katalog innerhalb des ImportCatalogPart Steuerelements hinzugefügt, und die verschiedenen Eigenschaften- und Zustandsdaten, die in der Beschreibungsdatei angegeben sind, werden auf das Steuerelement angewendet. Der Benutzer kann dann das Steuerelement auswählen und der Seite hinzufügen.

Wichtig

Wie die ExportWebPart Methode hat die ImportWebPart Methode ein gewisses Potenzial für Sicherheitsrisiken. Da es sich um das Importieren von Daten in eine Website handelt, kann ein böswilliger Benutzer versuchen, fehlerhafte Daten oder sogar Skriptcode in die importierte Beschreibungsdatei einzufügen. Dann könnten die fehlerhaften Daten auf einer Seite oder in einer Datenbank angezeigt werden, oder das eingefügte Skript könnte ausgeführt werden. Eine Übersicht über die potenziellen Risiken im Zusammenhang mit dem Importieren von Beschreibungsdateien und Möglichkeiten zum Vermeiden dieser Risiken finden Sie unter Schützen von Webpartsseiten.

Gilt für:

Weitere Informationen