This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

PersonalizableAttribute الفئة

Visual Studio 2010

يمثل السمة إضفاء طابع شخصي. و هذه الفئة لا يمكن أن تكون موروثة.

مساحة الاسم:  System.Web.UI.WebControls.WebParts
التجميع:  System.Web (في System.Web.dll)

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class PersonalizableAttribute : Attribute

استثناء:شرط
HttpException

الخاصية هو خاصية عامة للقراءة فقط أو للكتابة فقط.

-أو-

الخاصية هو خاصية خاصة أو محمية قراءه/كتابه.

-أو-

تحتوي خاصية على فهرس معلمات.

تخصيص السمة، Personalizable، هو تطبيق خصائص عناصر التحكم العامة والتي تحتاج إلى معلومات إضفاء طابع شخصي persهوt. ASP.NET تلقائياً بإنشاء تعليمات برمجية persهوt أو تخزين هذه قيم من بيانات المصدر عند استرداد عنصر التحكم هو في منطقة "أجزاء ويب" تشغيل صفحة "أجزاء ويب".

لابد من توفر المتطلبات التالية لخاصية إلى يتم وضع علامة personalizable:

  • يجب أن تكون خاصية العامة و يجب أن يحصل العامة و تعيين accessors.

  • يجب أن تكون الخاصية خاصية قراءه/كتابه.

  • يجب أن تكون خاصية بدون معلمات.

  • لا يمكن تمت الفهرسة خاصية.

ويتم تلقائياً إنشاء تعليمات برمجية لتحميل وحفظ بيانات التخصيص ل خصائص. خصائص that دعم إضفاء طابع شخصي are determined based تشغيل the existence of this سمة تشغيل the خاصية و the fact that the خاصية conforms إلى the constraints listed above.

لاحظ أن للقراءة فقط وخصائص كتابة فقط غير معتمدة للتخصيص. Applying this سمة إلى a read-فقط أو write-فقط خاصية نتائج في an HttpException being تم طرح. Parameterized خصائص also رمى an HttpException ‏‏ استثناء.

Individual خصائص without this سمة are مستثنى من إضفاء طابع شخصي if لا خاص handling through the IPersonalizable واجهة هو used.

للمزيد من المعلومات حول استخدام الواجهات, راجع نظرة عامة حول تخصيص أجزاء ويب.

The following تعليمات برمجية مثال demonstrates how إلى استخدم the PersonalizableAttribute فئة في تعليمات برمجية. The نموذج consists of an .aspx الصفحة that مراجع a ويب Part مستخدم عنصر تحكم called ColorSelector.ascx. The following تعليمات برمجية هو the .aspx ملف for the مثال.


<%@ Page Language="C#"  %>
<%@ Register TagPrefix="uc1" TagName="colorcontrol" Src="ColorSelector.ascx" %>
<!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 runat="server">
    <title>Untitled Page</title>
</head>

<body>
    <form id="form1" runat="server">
      <div>
        &nbsp;<asp:LoginName ID="LoginName1" runat="server" />
        &nbsp;
        <asp:LoginStatus ID="LoginStatus1" runat="server" LogoutAction="RedirectToLoginPage" />
        &nbsp;&nbsp;&nbsp;&nbsp;<br />
        <br />
        &nbsp;<asp:WebPartManager ID="WebPartManager1" runat="server">
        </asp:WebPartManager>

    </div>
        <asp:WebPartZone ID="WebPartZone1" runat="server"  Height="200" Width="200">
        <ZoneTemplate>
        <uc1:colorcontrol id="colorcontrol" runat="server" />
        </ZoneTemplate>
        </asp:WebPartZone>        
    </form>
</body>
</html>


The following تعليمات برمجية هو for the ColorSelector.ascx عنصر تحكم.

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر HTML. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


<%@ Control Language="C#" %>

<script runat="server">
private System.Drawing.Color userchoice;

[Personalizable]
public System.Drawing.Color UserColorChoice
{
   get
   {
     return userchoice;
   }
   set
   {
     userchoice = value;
   }
}

protected void OnRed(object src, EventArgs e)
{
  _color.BackColor = System.Drawing.Color.Red;
  UserColorChoice = System.Drawing.Color.Red;
}

protected void OnGreen(object src, EventArgs e)
{
  _color.BackColor = System.Drawing.Color.Green;
  UserColorChoice = System.Drawing.Color.Green;
}

protected void OnBlue(object src, EventArgs e)
{
  _color.BackColor = System.Drawing.Color.Blue;
  UserColorChoice = System.Drawing.Color.Blue;
}

protected void Page_Init(object src, EventArgs e)
{
  _redButton.Click   += new EventHandler(OnRed);  
  _greenButton.Click += new EventHandler(OnGreen);  
  _blueButton.Click  += new EventHandler(OnBlue);  
}

protected void Page_Load(object src, EventArgs e)
{
  if (!IsPostBack)
  {
          _color.BackColor = UserColorChoice;
  }
}

</script>
<body>
    <div>
        <asp:TextBox ID="_color" runat="server" Height="100" Width="100" />
        <br />
        <asp:button runat="server"  id="_redButton" text="Red"  /> 
        &nbsp;&nbsp;
        <asp:button runat="server"  id="_greenButton" text="Green" />
        &nbsp;&nbsp;
        <asp:button runat="server" id="_blueButton" text="Blue" />
    </div>
</body>


System.Object
  System.Attribute
    System.Web.UI.WebControls.WebParts.PersonalizableAttribute

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: