WebPartManager.ImportWebPart(XmlReader, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Importa um ficheiro de descrição XML que contém dados de estado e propriedades de um WebPart controlo, e aplica os dados ao controlo.
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 WebPartParâmetros
- reader
- XmlReader
Um XmlReader que lê os dados de estado e propriedades do ficheiro de descrição XML que está a ser importado.
- errorMessage
- String
A que é exibido ao utilizador se for encontrado um erro durante a String importação.
Devoluções
A WebPart (ou um controlo de servidor que é envolto por a GenericWebPart e, portanto, tratado como um WebPart) que é referenciado no ficheiro de descrição XML importado.
Exceções
reader é null.
reader Não consegui ler o ficheiro.
-ou-
reader precisou de mostrar uma mensagem de erro de importação, mas não encontrei nenhuma no ficheiro.
-ou-
reader chegou ao fim do ficheiro sem encontrar o elemento XML que contém os dados exportados.
Observações
O ImportWebPart método importa um ficheiro de descrição XML criado pelo ExportWebPart método para um controlo de servidor. Não é o controlo real do servidor que é importado, mas apenas o ficheiro de descrição que contém dados de estado e propriedades sobre o controlo. O controlo e o assembly referenciados no ficheiro de descrição devem já estar disponíveis no servidor onde o utilizador tenta importar o ficheiro de descrição.
Para permitir a importação de um controlo, um programador precisa de adicionar um CatalogZone controlo na página onde a importação estará ativada. Dentro da zona, deve ser adicionado um ImportCatalogPart controlo. Este controlo fornece uma caixa de diálogo de ficheiro que permite aos utilizadores navegar e localizar o ficheiro de descrição a importar.
Depois de um utilizador encontrar um ficheiro de descrição e iniciar a importação, o ficheiro de descrição é lido pelo ImportWebPart método. Se não houver erros e se a montagem e o controlo forem encontrados, o controlo do servidor é adicionado ao catálogo dentro do ImportCatalogPart controlo, e os vários dados de propriedades e estados especificados no ficheiro de descrição são aplicados ao controlo. O utilizador pode então selecionar o controlo e adicioná-lo à página.
Importante
Tal como o ExportWebPart método, este ImportWebPart tem algum potencial para riscos de segurança. Como envolve importar dados para um site, um utilizador malicioso pode tentar inserir dados errados ou até código de script no ficheiro de descrição que é importado. Assim, os dados errados podiam aparecer numa página, ou numa base de dados, ou o script inserido podia ser executado. Para uma visão geral dos potenciais riscos associados à importação de ficheiros de descrição e formas de evitar esses riscos, consulte Protegendo Páginas de Web Parts.