WebPartExportMode Sabit listesi
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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ı TextDisplayWebPart
bir 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 true
isSensitive
, 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 WebPartExportMode
WebPart.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 None
ayarlanır. Denetimin tüm özelliklerini dışarı aktarmayı etkinleştirmek için değerini olarak All
ayarlayı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 NonSensitiveData
ayarlarsı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>