WebPartExportMode Sabit listesi

Tanım

Denetimin özelliklerinin tümünün, bir WebPart bölümünün veya hiçbirinin dışarı aktarılıp aktarılamayacağını belirtir.

public enum class WebPartExportMode
public enum WebPartExportMode
type WebPartExportMode = 
Public Enum WebPartExportMode
Devralma
WebPartExportMode

Alanlar

All 1

Web Bölümleri denetiminin tüm özellikleri dışarı aktarılabilir.

None 0

Web Bölümleri denetiminin özelliklerinden hiçbiri dışarı aktarılamaz.

NonSensitiveData 2

Yalnızca hassas olmayan olarak tanımlanmış bir Web Bölümleri denetiminin özellikleri dışarı aktarılabilir.

Örnekler

Aşağıdaki örnekte özelliğinin kullanımı gösterilmektedir WebPart.ExportMode . Dışarı aktarma kodu örneğinin çalışması için , Açıklamalar bölümünde gösterildiği gibi Web.config dosyanızı da güncelleştirmeniz gerektiğini unutmayın.

Bu örneğin ilk bölümü adlı TextDisplayWebPartbir denetimin kodunu içerir. Bu denetim, sınıfın Örnekler bölümündeWebPart bulunan özel denetimle aynıdır; özelliğin dışarı aktarılabilmesi için özelliğine bir PersonalizableAttribute eklemesi TextDisplayWebPart.ContentText dışında. Öznitelik bildiriminin parametresi için değerini içerdiğini trueisSensitive , yani özelliğin dışarı aktarma amacıyla hassas veriler olarak işaretlendiğini unutmayın. Kod örneğinin çalışması için bu kaynak kodu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin çalışma zamanında dinamik olarak derlenecek App_Code klasörüne yerleştirebilirsiniz. Bu kod örneği, kaynak kodu bir derlemede derlediğiniz, Web uygulamanızın bir Bin alt klasörüne yerleştirdiğiniz ve Derlemeye Web sayfanızdaki bir Register yönergeyle başvurduğunuz varsayılır. Her iki derleme yöntemini de gösteren bir kılavuz için bkz. İzlenecek yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

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

Örneğin ikinci bölümünde, bir ASP.NET Web sayfasında denetime TextDisplayWebPart başvurma gösterilmektedir. Bildirim temelli işaretlemede özellik değerinin ExportMode Tümü olarak ayarlandığını, diğer bir deyişle hassas değerlere sahip özelliklerin bile dışarı aktarılacağını unutmayın.

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

Web sayfasını bir tarayıcıya yükleyin ve denetimin fiil menüsünde ExportMode dışarı aktarma fiiline tıklayın ve denetimin durumunu ve özellik verilerini içeren bir açıklama dosyasını dışarı aktarmak için yönergeleri izleyin.

Açıklamalar

Web Bölümleri denetiminden hangi özelliklerin WebPartExportModeWebPart.ExportMode dışarı aktarılabileceğini belirtmek için, numaralandırmadaki bir değer özelliğine uygulanabilir. Varsayılan olarak, bir WebPart denetimin özellikleri dışarı aktarılamaz ve denetimin ExportMode özelliği olarak Noneayarlanır. Denetimin tüm özelliklerini dışarı aktarmayı etkinleştirmek için değerini olarak AllayarlayınExportMode. Hassas veriler içeren özelliklerin dışarı aktarılmasını engellerken yalnızca belirli özellikleri dışarı aktarmak için özellik değerini olarak NonSensitiveDataayarlarsınız.

Bir özellik, özniteliği aracılığıyla PersonalizableAttribute hassas olarak işaretlenebilir.

Not

Web Bölümleri denetimleri içeren bir Web uygulamasının dışarı aktarma özelliğini etkinleştirmek için, uygulamanızın Web.config dosyasında, aşağıdaki işaretlemede olduğu gibi bölümün <system.web> içindeki öğesine bir öznitelik <webParts> eklemeniz gerekir:

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

Şunlara uygulanır

Ayrıca bkz.