WebPartManager.ImportWebPart(XmlReader, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Importe un fichier de description XML qui contient les données d'état et de propriété du contrôle WebPart et applique les données au contrôle.
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.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPartParamètres
- reader
- XmlReader
XmlReader qui lit les données d'état et de propriété à partir du fichier de description XML importé.
- errorMessage
- String
String qui s'affiche à l'attention de l'utilisateur si une erreur est rencontrée pendant l'importation.
Retours
WebPart (ou contrôle serveur encapsulé par un GenericWebPart et par conséquent traité comme un WebPart) qui est référencé dans le fichier de description XML importé.
Exceptions
reader a la valeur null.
reader n'a pas pu lire le fichier.
- ou -
reader devait afficher un message d'erreur d'importation mais n'en a pas trouvé dans le fichier.
- ou -
reader a atteint la fin du fichier sans trouver l'élément XML qui contient les données exportées.
Remarques
La ImportWebPart méthode importe un fichier de description XML créé par la ExportWebPart méthode pour un contrôle serveur. Ce n’est pas le contrôle serveur réel qui est importé, mais uniquement le fichier de description contenant les données d’état et de propriété relatives au contrôle. Le contrôle et l’assembly référencés dans le fichier de description doivent déjà être disponibles sur le serveur où un utilisateur tente d’importer le fichier de description.
Pour activer l’importation d’un contrôle, un développeur doit ajouter un CatalogZone contrôle sur la page où l’importation sera activée. Dans la zone, un ImportCatalogPart contrôle doit être ajouté. Ce contrôle fournit une boîte de dialogue de fichier qui permet aux utilisateurs de parcourir et de localiser le fichier de description à importer.
Une fois qu’un utilisateur a trouvé un fichier de description et a commencé l’importation, le fichier de description est lu par la ImportWebPart méthode . En l’absence d’erreurs et si l’assembly et le contrôle sont trouvés, le contrôle serveur est ajouté au catalogue au sein du ImportCatalogPart contrôle et les différentes données de propriété et d’état spécifiées dans le fichier de description sont appliquées au contrôle. L’utilisateur peut ensuite sélectionner le contrôle et l’ajouter à la page.
Important
À l’instar de la ExportWebPart méthode, la ImportWebPart méthode présente un risque potentiel pour la sécurité. Étant donné qu’il implique l’importation de données dans un site Web, un utilisateur malveillant peut essayer d’insérer des données incorrectes ou même de créer un script de code dans le fichier de description importé. Ensuite, les données incorrectes peuvent apparaître sur une page, ou dans une base de données, ou le script inséré peut s’exécuter. Pour obtenir une vue d’ensemble des risques potentiels associés à l’importation de fichiers de description et des moyens d’éviter ces risques, consultez Sécurisation des pages de composants WebPart.
