WebPartManager.ExportWebPart(WebPart, XmlWriter) 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.
Cria um ficheiro de descrição XML que contém dados de estado e propriedades para um controlo de servidor.
public:
virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);public virtual void ExportWebPart(System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)Parâmetros
- webPart
- WebPart
O controlo a partir do qual os dados serão exportados.
- writer
- XmlWriter
E XmlWriter que escreve os dados exportados para webPart um ficheiro de descrição XML.
Exceções
webPart não está contida na coleção de controlos referenciada em Controls.
-ou-
A ExportMode propriedade de webPart é definida para um valor de None, o que significa que a exportação está desativada para webPart.
Observações
O ExportWebPart método reúne vários dados de estado e propriedades num webPart ficheiro XML. Os dados incluem informações sobre o próprio controlo, incluindo a sua montagem, dados de estado e dados de propriedade. O utilizador que inicia a exportação pode guardar o ficheiro XML no disco no computador local ou na rede. Outros utilizadores podem então importar o ficheiro de descrição para uma página ou site diferente, e aplicar os dados de estado e propriedade a uma instância diferente de webPart. Isto proporciona um mecanismo rápido e conveniente para os utilizadores partilharem e reutilizarem as suas definições nos controlos do servidor, e também fornece aos programadores um meio de controlar a aparência e o comportamento dos controlos exportados e importados.
As propriedades ativadas webPart não são exportadas por defeito. Para permitir a exportação de uma propriedade, deve marcá-la com o [Personalizable] atributo no código-fonte. Também pode, opcionalmente, marcar uma propriedade exportável como contendo dados sensíveis, definindo o isSensitive parâmetro do [Personalizable] atributo para true. Por padrão, isSensitive é false. Os programadores podem definir o parâmetro para true indicar que os dados são sensíveis.
Para permitir webPart a exportação, um promotor define o valor da sua ExportMode propriedade para ( All incluindo todas as propriedades personalizáveis e sensíveis), ou para NonSensitiveData, que exporta tudo exceto propriedades sensíveis.
Importante
Permitir que os utilizadores exportem dados de controlos e importem dados para outros controlos implica alguns riscos de segurança. Os programadores devem usar a abordagem discutida acima para proteger dados sensíveis e, se quiserem evitar o risco de expor dados por completo, não devem ativar a exportação webPart . Para detalhes sobre questões de segurança das Web Parts, consulte as Páginas de Segurança das Web Parts.