Partilhar via


WebPartManager.ImportWebPart(XmlReader, String) Método

Definição

Importa um arquivo de descrição XML que contém dados de estado e de propriedade para um controle WebPart e aplica os dados ao controle.

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

Parâmetros

reader
XmlReader

Um XmlReader que lê os dados de estado e de propriedade do arquivo de descrição XML que está sendo importado.

errorMessage
String

Um String que é exibido para o usuário se for encontrado um erro durante a importação.

Retornos

WebPart

Um WebPart (ou um controle de servidor encapsulado por um GenericWebPart, portanto, tratado como um WebPart) que é referenciado no arquivo de descrição de XML importado.

Exceções

reader é null.

reader não pode ler o arquivo.

- ou - reader necessário para exibir uma mensagem de erro de importação, mas não foi possível localizar um no arquivo.

- ou - reader atingiu o fim do arquivo sem encontrar o elemento XML que contém os dados exportados.

Comentários

O ImportWebPart método importa um arquivo de descrição XML criado pelo ExportWebPart método para um controle de servidor. Não é o controle de servidor real importado, mas apenas o arquivo de descrição que contém dados de estado e propriedade sobre o controle. O controle e o assembly referenciados no arquivo de descrição já devem estar disponíveis no servidor em que um usuário tenta importar o arquivo de descrição.

Para habilitar a importação de um controle, um desenvolvedor precisa adicionar um CatalogZone controle na página em que a importação será habilitada. Dentro da zona, um ImportCatalogPart controle deve ser adicionado. Esse controle fornece uma caixa de diálogo de arquivo que permite que os usuários naveguem e localizem o arquivo de descrição a ser importado.

Depois que um usuário encontra um arquivo de descrição e inicia a importação, o arquivo de descrição é lido pelo ImportWebPart método. Se não houver erros e se o assembly e o controle forem encontrados, o controle do servidor será adicionado ao catálogo dentro do ImportCatalogPart controle e os vários dados de propriedade e estado especificados no arquivo de descrição serão aplicados ao controle. Em seguida, o usuário pode selecionar o controle e adicioná-lo à página.

Importante

Assim como o ExportWebPart método, o ImportWebPart método tem algum potencial para riscos de segurança. Como envolve a importação de dados para um site, um usuário mal-intencionado pode tentar inserir dados incorretos ou até mesmo um código de script no arquivo de descrição importado. Em seguida, os dados incorretos podem aparecer em uma página ou em um banco de dados ou o script inserido pode ser executado. Para obter uma visão geral dos riscos potenciais associados à importação de arquivos de descrição e maneiras de evitar esses riscos, consulte Proteger Web Parts Páginas.

Aplica-se a

Confira também