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.

C#
public enum WebPartExportMode
Devralma
WebPartExportMode

Alanlar

Name Değer Description
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.

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;
      }
    }
  }
}

Ö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.

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>

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:

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

Şunlara uygulanır

Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Ayrıca bkz.