WebPartManager.ExportSensitiveDataWarning Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe ou define o texto de uma mensagem de aviso que é exibida quando um utilizador tenta exportar dados de estado sensíveis de um WebPart controlo.

public:
 virtual property System::String ^ ExportSensitiveDataWarning { System::String ^ get(); void set(System::String ^ value); };
public virtual string ExportSensitiveDataWarning { get; set; }
member this.ExportSensitiveDataWarning : string with get, set
Public Overridable Property ExportSensitiveDataWarning As String

Valor de Propriedade

String

Uma cadeia que contém a mensagem de aviso. A mensagem padrão é um valor específico da cultura fornecido pelo .NET Framework.

Exemplos

O seguinte exemplo de código demonstra o uso declarativo da ExportSensitiveDataWarning propriedade.

O código da página Web seguinte usa um controlo padrão BulletedList e coloca-o numa zona. O controlo será envolto com um GenericWebPart controlo em tempo de execução, o que lhe permite atuar como um controlo verdadeiro WebPart . Para tornar o controlo exportável, é adicionado um ExportMode atributo ao <asp:bulletedlist> elemento, e o valor do atributo é definido para All, o que significa que tanto dados sensíveis como não sensíveis podem ser exportados. Note também que, no <asp:webpartmanager> elemento, o ExportSensitiveDataWarning atributo recebe um valor personalizado.

Note que, para o exemplo de código funcionar, existe uma definição que deve adicionar no ficheiro Web.config para permitir a exportação de ficheiros de descrição de Web Parts. Certifique-se de que tem um ficheiro Web.config no mesmo diretório da página Web para este exemplo de código. Dentro da <system.web> secção, certifique-se de que existe um <webParts> elemento com um enableExport atributo definido como true, como na marcação seguinte.

<webParts enableExport="true">

...

</webParts>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" 
        runat="server" 
        ExportSensitiveDataWarning="Sensitive data is being exported"/>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList> 
        </ZoneTemplate>
      </asp:WebPartZone>
      </div>
     </form>
</body>
</html>

<%@ Page Language="vb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server" />
      <asp:WebPartManager ID="WebPartManager2" 
        runat="server" 
        ExportSensitiveDataWarning="Sensitive data is being exported"/>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList> 
        </ZoneTemplate>
      </asp:WebPartZone>
      </div>
     </form>
</body>
</html>

Depois de carregar a página num navegador, clique no menu verbos (representado por uma seta para baixo) na barra de título do controlo que contém os links. No menu de verbos, selecione Exportar e repare que aparece uma caixa de mensagem com o aviso personalizado. Se quiser continuar com a exportação, clique em OK, o que lhe permitirá guardar uma cópia local de um ficheiro de descrição XML com todos os dados sobre o controlo.

Observações

Quando um utilizador tenta exportar dados de estado sensíveis a partir de um WebPart controlo, se algum dos dados exportados vier de um membro marcado como sensível no código-fonte, é exibida uma mensagem de aviso ao utilizador numa caixa de mensagem, informando que dados sensíveis estão a ser exportados e proporcionando uma oportunidade para cancelar a exportação. Os programadores podem marcar os dados de um membro específico como sensíveis definindo o isSensitive parâmetro do [Personalizable] atributo no true membro. Para mais informações sobre este atributo e parâmetro, consulte a PersonalizableAttribute classe.

Importante

Quando utiliza a funcionalidade de exportação das Web Parts, dados sensíveis podem potencialmente ser exportados para utilizadores não autorizados. Para detalhes sobre como se proteger contra esta ameaça, consulte Páginas de Segurança de Web Parts.

A mensagem padrão é exibida sempre que os utilizadores tentam exportar. No entanto, ao atribuir um valor à ExportSensitiveDataWarning propriedade, pode fornecer uma mensagem de aviso personalizada.

Aplica-se a

Ver também