WebPartExportMode Énumération

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Spécifie si toutes, certaines ou aucune des propriétés d'un contrôle WebPart peuvent être exportées.

C#

public enum WebPartExportMode

Héritage

Object

ValueType

Enum

WebPartExportMode

Champs

Nom	Valeur	Description
All	1	Toutes les propriétés d'un contrôle WebPart peuvent être exportées.
None	0	Aucune propriété d'un contrôle WebPart ne peut être exportée.
NonSensitiveData	2	Seules les propriétés d'un contrôle WebPart qui ont été définies comme non sensibles peuvent être exportées.

Exemples

L’exemple suivant illustre l’utilisation de la WebPart.ExportMode propriété . Notez que pour que l’exemple de code d’exportation fonctionne, vous devez également mettre à jour votre fichier Web.config, comme indiqué dans la section Remarques .

La première partie de cet exemple contient le code d’un contrôle nommé TextDisplayWebPart. Ce contrôle est identique au contrôle personnalisé qui se trouve dans la section Exemples de la WebPart classe, sauf qu’il ajoute un PersonalizableAttribute à la TextDisplayWebPart.ContentText propriété afin que la propriété puisse être exportée. Notez que la déclaration d’attribut inclut une valeur de true pour le isSensitive paramètre, ce qui signifie que la propriété est marquée comme des données sensibles à des fins d’exportation. Pour que l’exemple de code s’exécute, vous devez compiler ce code source. Vous pouvez le compiler explicitement et placer l’assembly résultant dans le dossier Bin de votre site web ou dans le global assembly cache. Vous pouvez également placer le code source dans le dossier App_Code de votre site, où il sera compilé dynamiquement au moment de l’exécution. Cet exemple de code part du principe que vous compilez le code source dans un assembly, que vous le placez dans un sous-dossier Bin de votre application web et que vous référencez l’assembly avec une Register directive dans votre page web. Pour obtenir une procédure pas à pas qui illustre les deux méthodes de compilation, consultez Procédure pas à pas : développement et utilisation d’un contrôle de serveur web personnalisé.

C#

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    const string _subTitle = "Contoso, Ltd";

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [
      Personalizable(PersonalizationScope.User, true),
      WebBrowsable()
    ]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
      ChildControlsCreated = true;
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

La deuxième partie de l’exemple montre comment référencer le TextDisplayWebPart contrôle dans une page Web ASP.NET. Notez que dans le balisage déclaratif, la valeur de la ExportMode propriété est définie sur All, ce qui signifie que même les propriétés avec des valeurs sensibles seront exportées.

ASP.NET (C#)

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>

<!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">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text WebPart" 
            ExportMode="All" 
            />
        </zonetemplate>
    </asp:webpartzone>
    <br />
  </form>
</body>
</html>

Chargez la page Web dans un navigateur et, dans le menu Verbes du contrôle, cliquez sur le ExportMode verbe d’exportation et suivez les instructions pour exporter un fichier de description contenant les données d’état et de propriété du contrôle.

Remarques

Une valeur de l’énumération WebPartExportMode peut être appliquée à la WebPart.ExportMode propriété pour spécifier les propriétés d’un contrôle WebPart qui peuvent être exportées. Par défaut, les propriétés d’un WebPart contrôle ne peuvent pas être exportées et la propriété du ExportMode contrôle est définie sur None. Pour activer l’exportation de toutes les propriétés du contrôle, définissez la ExportMode valeur sur All. Pour exporter uniquement certaines propriétés tout en empêchant l’exportation de propriétés qui contiennent des données sensibles, vous définissez la valeur de la propriété sur NonSensitiveData.

Une propriété peut être marquée comme sensible via l’attribut PersonalizableAttribute .

Note

Pour activer la fonctionnalité d’exportation d’une application web qui inclut des contrôles De composants WebPart, dans le fichier Web.config de votre application, vous devez ajouter un attribut à l’élément dans la <webParts><system.web> section, comme dans le balisage suivant :

XML

<webParts enableExport="true">
</webParts>

S’applique à

Voir aussi

• PersonalizableAttribute
• ImportCatalogPart
• contrôles de composants WebPart ASP.NET