WebPartManager.ExportWebPart(WebPart, XmlWriter) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.