WebPartManager.ExportWebPart(WebPart, XmlWriter) Método

Definição

Cria um arquivo de descrição de XML que contém dados de estado e de propriedade de um controle 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 -> unit
Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

Parâmetros

webPart
WebPart

O controle do qual os dados serão exportados.

writer
XmlWriter

Uma XmlWriter que grava os dados exportados do webPart em um arquivo de descrição de XML.

Exceções

webPart é null.

- ou - writer é null.

webPart não está contido na coleção de controles referenciada em Controls.

- ou - A propriedade ExportMode de webPart está definida como um valor de None, o que significa que a exportação está desabilitada para webPart.

Comentários

O ExportWebPart método reúne vários dados de estado e propriedade de webPart um arquivo XML. Os dados incluem informações sobre o próprio controle, incluindo seu assembly, dados de estado e dados de propriedade. O usuário que inicia a exportação pode salvar o arquivo XML em disco no computador local ou na rede. Em seguida, outros usuários podem importar o arquivo 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. Isso fornece um mecanismo rápido e conveniente para que os usuários compartilhem e reutilizem suas configurações em controles de servidor e também fornece aos desenvolvedores um meio de controlar a aparência e o comportamento dos controles exportados e importados.

As propriedades não webPart são exportadas por padrão. Para habilitar a exportação de uma propriedade, você deve marcá-la com o [Personalizable] atributo no código-fonte. Opcionalmente, você também pode marcar uma propriedade exportável como contendo dados confidenciais, definindo o isSensitive parâmetro do [Personalizable] atributo como true. Por padrão, isSensitive é false. Os desenvolvedores podem definir o parâmetro para true indicar que os dados são confidenciais.

Para habilitar webPart a exportação, um desenvolvedor define seu ExportMode valor de propriedade como All (que inclui todas as propriedades personalizáveis e confidenciais) ou para NonSensitiveData, que exporta tudo, exceto propriedades confidenciais.

Importante

Permitir que os usuários exportem dados de controles e importem dados para outros controles implica alguns riscos de segurança. Os desenvolvedores devem usar a abordagem discutida acima para proteger dados confidenciais e, se quiserem evitar o risco de expor os dados completamente, eles não devem habilitar a exportação webPart . Para obter detalhes sobre Web Parts problemas de segurança, consulte Proteção de páginas de Web Parts.

Aplica-se a

Confira também