WebPartManager.ExportSensitiveDataWarning プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls.WebParts

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザーが 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

プロパティ値

String

警告メッセージが含まれた文字列。既定のメッセージは、.NET Framework が提供するカルチャ固有の値です。

例

次のコード例では、プロパティの宣言型の使用方法を ExportSensitiveDataWarning 示します。

次の Web ページのコードは、標準 BulletedList コントロールを使用してゾーンに配置します。コントロールは実行時にコントロールと共 GenericWebPart にラップされます。これにより、コントロールは真 WebPart のコントロールとして機能します。コントロールをエクスポート可能にするために、 ExportMode 属性が要素に <asp:bulletedlist> 追加され、属性値がに All設定されます。つまり、機密データと機密以外のデータの両方をエクスポートできます。また、要素では <asp:webpartmanager> 、属性に ExportSensitiveDataWarning カスタム値が割り当てられることにも注意してください。

コード例を機能させるには、Web パーツ記述ファイルのエクスポートを有効にするために、Web.config ファイルに追加する必要がある設定があることに注意してください。このコード例の Web ページと同じディレクトリに 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>

ブラウザーでページを読み込んだ後、リンクを含むコントロールのタイトルバーにある動詞メニュー (下向き矢印で表されます) をクリックします。動詞メニューで [ エクスポート] を選択し、メッセージボックスにカスタム警告が表示されていることを確認します。エクスポートを続行する場合は、[ OK] をクリックします。これにより、コントロールに関するすべてのデータを含む XML 記述ファイルのローカルコピーを保存できます。

注釈

ユーザーがコントロールから WebPart 機密状態データをエクスポートしようとすると、エクスポートされるデータのいずれかがソースコードで機密としてマークされたメンバーから送信された場合、警告メッセージがメッセージボックスに表示され、機密データがエクスポートされていることを通知し、エクスポートを取り消す機会が提供されます。開発者は、属性trueのパラメーターをメンバーに設定することで、isSensitive特定のメンバーのデータを[Personalizable]機密としてマークできます。この属性とパラメーターの詳細については、クラスを PersonalizableAttribute 参照してください。

重要

Web パーツのエクスポート機能を使用すると、機密データが承認されていないユーザーにエクスポートされる可能性があります。この脅威から保護する方法の詳細については、「 Web パーツページのセキュリティ保護」を参照してください。

既定のメッセージは、ユーザーがエクスポートを試みるたびに表示されます。ただし、プロパティに ExportSensitiveDataWarning 値を割り当てることで、カスタム警告メッセージを指定できます。

適用対象

次の方法で共有

WebPartManager.ExportSensitiveDataWarning プロパティ

定義

プロパティ値

例

注釈

適用対象

こちらもご覧ください

その他のリソース