Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

WebPartManager.ExportSensitiveDataWarning-Eigenschaft

.NET Framework 3.5

Aktualisiert: November 2007

Ruft den Text einer Warnmeldung ab, die angezeigt wird, wenn versucht wird, vertrauliche Zustandsdaten aus einem WebPart-Steuerelement zu exportieren, oder legt diesen Text fest.

Namespace: System.Web.UI.WebControls.WebParts
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public virtual string ExportSensitiveDataWarning { get; set; }

/** @property */
public String get_ExportSensitiveDataWarning()
/** @property */
public  void set_ExportSensitiveDataWarning(String value)

JScript

public function get ExportSensitiveDataWarning () : String
public function set ExportSensitiveDataWarning (value : String)

ASP.NET

<asp:WebPartManager ExportSensitiveDataWarning="String" />

Eigenschaftenwert

Typ: System.String
Eine Zeichenfolge, die die Warnmeldung enthält. Die Standardmeldung ist ein von .NET Framework bereitgestellter kulturspezifischer Wert.

Hinweise

Wenn ein Benutzer versucht, vertrauliche Zustandsdaten aus einem WebPart-Steuerelement zu exportieren, d. h., wenn Teile der Daten, die exportiert werden, von einem im Quellcode als vertraulich gekennzeichneten Member stammen, wird eine Warnmeldung in einem Meldungsfeld angezeigt, die dem Benutzer mitteilt, dass vertrauliche Daten exportiert werden. Der Benutzer erhält die Möglichkeit, den Exportvorgang abzubrechen. Entwickler können die Daten von bestimmten Membern als vertraulich kennzeichnen, indem sie den isSensitive-Parameter des [Personalizable]-Attributs für den Member auf true festlegen. Weitere Informationen zu diesem Attribut und diesem Parameter finden Sie unter der PersonalizableAttribute-Klasse.

Sicherheitshinweis:
Mit dem Webparts-Exportfeature können vertrauliche Daten potenziell an nicht autorisierte Benutzer exportiert werden. Einzelheiten zum Schutz vor dieser Bedrohung finden Sie unter Absichern von Webparts-Seiten.

Bei jedem Versuch, Daten zu exportieren, wird die Standardmeldung angezeigt. Sie können jedoch eine benutzerdefinierte Warnmeldung bereitstellen, indem Sie der ExportSensitiveDataWarning-Eigenschaft einen Wert zuweisen.

Beispiele

Im folgenden Codebeispiel wird die deklarative Verwendung der ExportSensitiveDataWarning-Eigenschaft veranschaulicht.

Im Code für die folgende Webseite wird ein BulletedList-Standardsteuerelement verwendet und in einer Zone platziert. Das Steuerelement wird zur Laufzeit mit einem GenericWebPart-Steuerelement in einen Wrapper eingeschlossen, wodurch es als echtes WebPart-Steuerelement fungieren kann. Um das Steuerelement exportierbar zu machen, wird dem <asp:bulletedlist>-Element ein ExportMode-Attribut hinzugefügt, und der Attributwert wird auf All festgelegt. Dies bedeutet, dass sowohl vertrauliche als auch nicht vertrauliche Daten exportiert werden können. Im ExportSensitiveDataWarning-Attribut wird dem <asp:webpartmanager>-Element ein benutzerdefinierter Wert zugewiesen.

Damit das Codebeispiel funktioniert, müssen Sie der Datei Web.config eine Einstellung hinzufügen, um den Export von Webparts-Beschreibungsdateien zu aktivieren. Stellen Sie sicher, dass sich im Verzeichnis für die Webseite dieses Codebeispiels auch eine Datei Web.config befindet. Vergewissern Sie sich, dass im <system.web>-Abschnitt wie im folgenden Markup ein <webParts>-Element mit einem auf true festgelegten enableExport-Attribut vorhanden ist.

...

</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>

Klicken Sie nach dem Laden der Seite in einem Browser auf der Titelleiste des Steuerelements, das die Verknüpfungen enthält, auf das Verbenmenü (Pfeil nach unten). Wählen Sie im Verbenmenü Exportieren aus. Daraufhin wird ein Meldungsfeld mit der benutzerdefinierten Warnung angezeigt. Wenn Sie den Exportvorgang fortsetzen möchten, klicken Sie auf OK, wodurch Sie eine lokale Kopie einer XML-Beschreibungsdatei mit allen Daten zu dem Steuerelement speichern können.

Plattformen

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen