WebPartManager.ExportSensitiveDataWarning Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает текст предупреждения, которое отображается при попытке пользователем экспортировать конфиденциальные данные состояния из элемента управления WebPart.
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
Значение свойства
Строка, содержащая предупреждение. Сообщением по умолчанию является соответствующее конкретному языку значение, которое предоставляется платформой .NET Framework.
Примеры
В следующем примере кода демонстрируется декларативное использование ExportSensitiveDataWarning свойства.
Код для следующей веб-страницы использует стандартный BulletedList элемент управления и помещает его в зону. Элемент управления будет упакован с элементом GenericWebPart управления во время выполнения, что позволяет ему действовать как истинный WebPart элемент управления. Чтобы сделать элемент управления экспортируемым, ExportMode
к элементу добавляется <asp:bulletedlist>
атрибут, а значение атрибута — Allэто означает, что можно экспортировать как конфиденциальные, так и не конфиденциальные данные. Обратите внимание, что в элементе <asp:webpartmanager>
ExportSensitiveDataWarning
атрибуту присваивается пользовательское значение.
Обратите внимание, что для работы примера кода необходимо добавить параметр в файл Web.config, чтобы включить экспорт файлов описания веб-части. Убедитесь, что у вас есть файл Web.config в том же каталоге, что и веб-страница для этого примера кода. <system.web>
В разделе убедитесь, что в разделе есть <webParts>
элемент с заданным true
атрибутомenableExport
, как показано в следующей разметке.
<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>
После загрузки страницы в браузере щелкните меню команд (представленные стрелкой вниз) в заголовке элемента управления, содержащего ссылки. В меню команд выберите "Экспорт" и обратите внимание, что появится окно сообщения с настраиваемым предупреждением. Если вы хотите продолжить экспорт, нажмите кнопку "ОК", чтобы сохранить локальную копию XML-файла описания со всеми данными об элементе управления.
Комментарии
Когда пользователь пытается экспортировать конфиденциальные данные состояния из WebPart элемента управления, если какой-либо из экспортируемых данных поступает от члена, который был помечен как конфиденциальный в исходном коде, в окне сообщения отображается предупреждающее сообщение, сообщая ему, что конфиденциальные данные экспортируются и предоставляют возможность отменить экспорт. Разработчики могут пометить данные определенного члена как конфиденциальные, задав isSensitive
параметр [Personalizable]
атрибута true
для элемента. Дополнительные сведения об этом атрибуте и параметре см. в описании PersonalizableAttribute класса.
Важно!
При использовании функции экспорта веб-части конфиденциальные данные могут быть экспортированы несанкционированным пользователям. Дополнительные сведения о защите от этой угрозы см. в разделе "Защита веб-части Pages".
Сообщение по умолчанию отображается всякий раз, когда пользователи пытаются экспортировать. Однако, назначив значение свойству ExportSensitiveDataWarning , можно предоставить пользовательское предупреждающее сообщение.