WebPartExportMode Enum

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls.WebParts
Rakitan:
System.Web.dll

Menentukan apakah semua, beberapa, atau tidak ada properti kontrol yang WebPart dapat diekspor.

public enum class WebPartExportMode
public enum WebPartExportMode
type WebPartExportMode = 
Public Enum WebPartExportMode
Warisan
Object
ValueType
Enum
WebPartExportMode

Bidang

All 1

Semua properti kontrol Bagian Web dapat diekspor.
None 0

Tidak ada properti kontrol Bagian Web yang dapat diekspor.
NonSensitiveData 2

Hanya properti kontrol Bagian Web yang telah didefinisikan sebagai tidak sensitif yang dapat diekspor.

Contoh

Contoh berikut menunjukkan penggunaan WebPart.ExportMode properti . Perhatikan bahwa agar contoh kode ekspor berfungsi, Anda juga harus memperbarui file Web.config, seperti yang ditunjukkan di bagian Keterangan .

Bagian pertama dari contoh ini berisi kode untuk kontrol bernama TextDisplayWebPart. Kontrol ini sama dengan kontrol kustom yang ditemukan di bagianWebPart Contoh kelas, kecuali bahwa kontrol ini menambahkan PersonalizableAttribute ke TextDisplayWebPart.ContentText properti sehingga properti dapat diekspor. Perhatikan bahwa deklarasi atribut menyertakan nilai true untuk isSensitive parameter , yang berarti bahwa properti ditandai sebagai data sensitif untuk tujuan ekspor. Agar contoh kode berjalan, Anda harus mengkompilasi kode sumber ini. Anda dapat mengkompilasinya secara eksplisit dan meletakkan rakitan yang dihasilkan di folder Bin situs Web Anda atau cache perakitan global. Atau, Anda dapat meletakkan kode sumber di folder App_Code situs Anda, tempat kode tersebut akan dikompilasi secara dinamis pada durasi. Contoh kode ini mengasumsikan bahwa Anda mengkompilasi kode sumber ke dalam perakitan, menempatkannya di subfolder Bin aplikasi Web Anda, dan mereferensikan perakitan dengan Register arahan di halaman Web Anda. Untuk panduan yang menunjukkan kedua metode kompilasi, lihat Panduan: Mengembangkan dan Menggunakan Kontrol Server Web Kustom.

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

Bagian kedua dari contoh menunjukkan cara mereferensikan TextDisplayWebPart kontrol di halaman web ASP.NET. Perhatikan bahwa dalam markup deklaratif, ExportMode nilai properti diatur ke Semua, yang berarti bahwa bahkan properti dengan nilai sensitif akan diekspor.

<%@ 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>

Muat halaman Web di browser, dan pada menu ExportMode kata kerja kontrol, klik kata kerja ekspor dan ikuti instruksi untuk mengekspor file deskripsi yang berisi status kontrol dan data properti.

Keterangan

Nilai dari WebPartExportMode enumerasi dapat diterapkan ke WebPart.ExportMode properti untuk menentukan properti mana dari kontrol Bagian Web yang dapat diekspor. Secara default, properti WebPart kontrol tidak dapat diekspor, dan properti kontrol ExportMode diatur ke None. Untuk mengaktifkan ekspor semua properti untuk kontrol, atur nilai ke ExportModeAll. Untuk mengekspor hanya properti tertentu sambil mencegah ekspor properti yang berisi data sensitif, Anda mengatur nilai properti ke NonSensitiveData.

Properti dapat ditandai sebagai sensitif melalui PersonalizableAttribute atribut .

Catatan

Untuk mengaktifkan fitur ekspor untuk aplikasi Web yang menyertakan kontrol Bagian Web, dalam file Web.config untuk aplikasi Anda, Anda harus menambahkan atribut ke <webParts> elemen di dalam <system.web> bagian , seperti dalam markup berikut:

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

Berlaku untuk

Lihat juga