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 des données d’état et de propriété pour un WebPart contrôle 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
Qui XmlReader lit les données d’état et de propriété du fichier de description XML en cours d’importation.
- errorMessage
- String
Qui String s’affiche à l’utilisateur si une erreur est rencontrée lors de l’importation.
Retours
Un WebPart (ou un contrôle serveur encapsulé par un GenericWebPart et donc traité comme un WebPart) référencé dans le fichier de description XML importé.
Exceptions
reader a la valeur null.
reader impossible de lire le fichier.
- ou -
reader nécessaire pour afficher un message d’erreur d’importation, mais il n’en a pas trouvé dans le fichier.
- ou -
reader 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 d’un contrôle serveur. Il ne s’agit pas du contrôle serveur réel importé, mais uniquement du fichier de description contenant des données d’état et de propriété sur le 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 trouve un fichier de description et commence l’importation, le fichier de description est lu par la ImportWebPart méthode. S’il n’y a aucune erreur et si l’assembly et le contrôle sont trouvés, le contrôle serveur est ajouté au catalogue dans le 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
Comme la ExportWebPart méthode, la ImportWebPart méthode présente des risques de 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 du code de script 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 La sécurisation des pages de composants WebPart.
