WebPartExportMode Enumerazione

Definizione

Specifica se è possibile esportare tutte, alcune o nessuna delle proprietà di un controllo WebPart.Specifies whether all, some, or none of a WebPart control's properties can be exported.

public enum class WebPartExportMode
public enum WebPartExportMode
type WebPartExportMode = 
Public Enum WebPartExportMode
Ereditarietà
WebPartExportMode

Campi

All 1

È possibile esportare tutte le proprietà di un controllo web part.All of a Web Parts control's properties can be exported.

None 0

Non è possibile esportare alcuna proprietà di un controllo Web part.None of a Web Parts control's properties can be exported.

NonSensitiveData 2

È possibile esportare solo le proprietà di un controllo Web part definite come non sensibili.Only properties of a Web Parts control that have been defined as non-sensitive can be exported.

Esempi

Nell'esempio seguente viene illustrato l'utilizzo della WebPart.ExportMode proprietà.The following example demonstrates the use of the WebPart.ExportMode property. Si noti che per il corretto funzionamento dell'esempio di codice di esportazione, è necessario aggiornare anche il file Web. config, come indicato nella sezione osservazioni .Note that for the export code example to work, you must also update your Web.config file, as indicated in the Remarks section.

La prima parte di questo esempio contiene il codice per un controllo denominato TextDisplayWebPart.The first part of this example contains the code for a control named TextDisplayWebPart. Questo controllo corrisponde al controllo personalizzato presente nella sezione degli esempi WebPart della classe, ad eccezione del fatto che TextDisplayWebPart.ContentText aggiunge un oggetto PersonalizableAttribute alla proprietà in modo che la proprietà possa essere esportata.This control is the same as the custom control that is found in the Examples section of the WebPart class, except that it adds a PersonalizableAttribute to the TextDisplayWebPart.ContentText property so the property can be exported. Si noti che la dichiarazione di attributo include un true valore per isSensitive il parametro, vale a dire che la proprietà è contrassegnata come dati sensibili per scopi di esportazione.Note that the attribute declaration includes a value of true for the isSensitive parameter, meaning that the property is marked as sensitive data for export purposes. Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente.For the code example to run, you must compile this source code. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella bin del sito Web o nel Global Assembly Cache.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato dinamicamente in fase di esecuzione.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. In questo esempio di codice si presuppone che il codice sorgente venga compilato in un assembly, inserito in una sottocartella bin dell'applicazione Web e fare riferimento all'assembly con Register una direttiva nella pagina Web.This code example assumes that you compile the source code into an assembly, place it in a Bin subfolder of your Web application, and reference the assembly with a Register directive in your Web page. Per una procedura dettagliata in cui vengono illustrati entrambi i metodi di compilazione, vedere Procedura dettagliata: Sviluppo e utilizzo di un controlloserver Web personalizzato.For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

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;
      }
    }
  }
}
Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class TextDisplayWebPart 
  Inherits WebPart
  Private _contentText As String = Nothing
  Private input As TextBox
  Private DisplayContent As Label 
  Private Const _subTitle as String = "Contoso, Ltd"
  
  
  Public Sub New()  
    Me.AllowClose = False 
  End Sub 
  
  <Personalizable(PersonalizationScope.User, True), _
   WebBrowsable()>  _ 
  Public Property ContentText() As String 
    Get 
      Return _contentText 
    End Get 
    Set 
      _contentText = value
    End Set 
  End Property
    
  Protected Overrides Sub CreateChildControls() 
    Controls.Clear()
    DisplayContent = New Label()
    DisplayContent.Text = Me.ContentText
    DisplayContent.BackColor = _
      System.Drawing.Color.LightBlue
    Me.Controls.Add(DisplayContent) 
    input = New TextBox() 
    Me.Controls.Add(input)
    Dim update As New Button()
    update.Text = "Set Label Content" 
    AddHandler update.Click, AddressOf Me.submit_Click
    Me.Controls.Add(update) 
    ChildControlsCreated = True 
  
  End Sub 

  Private Sub submit_Click(ByVal sender As Object, _
                           ByVal e As EventArgs)  
    ' Update the label string.
    If input.Text <> String.Empty Then
      _contentText = input.Text & "<br />"
      input.Text = String.Empty 
      DisplayContent.Text = Me.ContentText
    End If
  
  End Sub 
  
End Class 

End Namespace 

Nella seconda parte dell'esempio viene illustrato come fare riferimento al TextDisplayWebPart controllo in una pagina Web ASP.NET.The second part of the example shows how to reference the TextDisplayWebPart control in an ASP.NET Web page. Si noti che nel markup dichiarativo ExportMode , il valore della proprietà è impostato su All, ovvero verranno esportate anche le proprietà con valori sensibili.Note that in the declarative markup, the ExportMode property value is set to All, meaning that even properties with sensitive values will be exported.

<%@ 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>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

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

Caricare la pagina Web in un browser e nel menu dei verbi del ExportMode controllo fare clic sul verbo di esportazione e seguire le istruzioni per esportare un file di descrizione contenente i dati relativi allo stato e alla proprietà del controllo.Load the Web page in a browser, and on the verbs menu of the ExportMode control, click the export verb and follow the instructions to export a description file containing the control's state and property data.

Commenti

È possibile applicare un WebPartExportMode valore dell'enumerazione WebPart.ExportMode alla proprietà per specificare quali proprietà di un controllo Web part possono essere esportate.A value from the WebPartExportMode enumeration can be applied to the WebPart.ExportMode property to specify which properties from a Web Parts control can be exported. Per impostazione predefinita, le proprietà di WebPart un controllo non possono essere esportate e ExportMode la proprietà del controllo Noneè impostata su.By default, the properties of a WebPart control cannot be exported, and the control's ExportMode property is set to None. Per abilitare l'esportazione di tutte le proprietà per il controllo ExportMode , impostare Allil valore su.To enable exporting all properties for the control, set the ExportMode value to All. Per esportare solo determinate proprietà impedendo l'esportazione di proprietà che contengono dati sensibili, impostare il valore della proprietà su NonSensitiveData.To export only certain properties while preventing the export of properties that contain sensitive data, you set the property value to NonSensitiveData.

Una proprietà può essere contrassegnata come sensibile tramite PersonalizableAttribute l'attributo.A property can be marked as sensitive through the PersonalizableAttribute attribute.

Nota

Per abilitare la funzionalità di esportazione per un'applicazione Web che include Web Part controlli, nel file Web. config dell'applicazione è necessario aggiungere un attributo all' <webParts> elemento all'interno della <system.web> sezione, come nel markup seguente:To enable the export feature for a Web application that includes Web Parts controls, in the Web.config file for your application, you must add an attribute to the <webParts> element within the <system.web> section, as in the following markup:

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

Si applica a

Vedi anche