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.

WebPartManager.Personalization الخاصية

Visual Studio 2010

يحصل على مرجع إلى كائن يحتوي على بيانات التخصيص صفحة ويب.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public WebPartPersonalization Personalization { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.WebParts.WebPartPersonalization
A WebPartPersonalization that يحتوي على إضفاء طابع شخصي بيانات.

The Personalization خاصية provides a way إلى الوصول the WebPartPersonalization كائن that هو associated مع a الصفحة through the WebPartManager عنصر تحكم. Using this خاصية, you can الوصول the متنوع الأعضاء of the إضفاء طابع شخصي كائن. على سبيل المثال، يمكنك استخدام ToggleScopeطريقة للتبديل لصفحة نطاق إضفاء الطابع الشخصي من مشاركة للنطاق المستخدم، أو vice العكس. You can also بحث خارج the الحالي إضفاء طابع شخصي نطاق of the الصفحة, whether إضفاء طابع شخصي زوجي ممكّن تشغيل the الصفحة, which موفر هو being used for the إضفاء طابع شخصي بيانات, و المزيد.

ملاحظة that the بيانات مشار إليها بواسطة the Personalization خاصية هو فقط the الصفحة-المستوى إضفاء طابع شخصي بيانات that هو tracked بواسطة the WebPartManager عنصر تحكم. عنصر تحكم-specific إضفاء طابع شخصي بيانات, such كـ the قيم of personalizable خصائص تشغيل WebPart عناصر التحكم, ليس part of the Personalization خاصية.

ملاحظةملاحظة

For المزيد معلومات تشغيل ويب Parts إضفاء طابع شخصي, see نظرة عامة حول تخصيص أجزاء ويب.

The following تعليمات برمجية مثال demonstrates how إلى استخدم the Personalization خاصية programmatically.

The following ويب الصفحة allows a مستخدم إلى Enter الزر تحرير الوضع إلى تحرير certain aspects of the Calendar عنصر تحكم. النطاق التبديل زر تبديل الصفحة لمستخدم نطاق إضفاء الطابع الشخصي المشترك. الوضع التحرير الوضع استعراض الأزرار و كل التبديل الصفحة في الوضع العرض المناسبة. ملاحظة أنه فى <script> العلامة المقطع من الملف اثنين أساليب معالجة استخدام الأحداث Personalization صواب للوصول أعضاء مفيدة من الكائن المصدر. Specifically, these وظائف استخدم the ToggleScope أسلوب و the Scope خاصية تشغيل the كائن accessed through the Personalization خاصية.


<%@ Page Language="c#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    if ((mgr1.Personalization.Scope == PersonalizationScope.User)
      && (mgr1.Personalization.CanEnterSharedScope))
    {
      mgr1.Personalization.ToggleScope();
    }
    else if (mgr1.Personalization.Scope ==
      PersonalizationScope.Shared)
    {
      mgr1.Personalization.ToggleScope();
    }
    else
    {
      // If the user cannot enter shared scope you may want
      // to notify them on the page.
    }
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.EditDisplayMode;
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    Label1.Text = "Scope is: "
      + mgr1.Personalization.Scope.ToString();
  }
</script>

<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">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
            runat="server"  />
          <asp:BehaviorEditorPart ID="BehaviorEditorPart1" 
            runat="server" />
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Toggle Scope" OnClick="Button1_Click"  />
      <asp:Button ID="Button2" runat="server" Text="Edit Mode" OnClick="Button2_Click" />
      <asp:Button ID="Button3" runat="server" Text="Browse Mode" OnClick="Button3_Click" />
      <br />
      <asp:Label ID="Label1" runat="server" Text="" />
     </div>
     </form>
</body>
</html>


For the تعليمات برمجية مثال إلى تشغيل, you also must تمكين a مستخدم أو users إلى personalize الصفحات في shared نطاق. قم بإضافة إدخال إلى ملف ويب.config، داخل <system.web>مقطع، الذي يبدو مثل ترميز التالية.

<webParts>
  <personalization>
    <authorization>
      <allow
        users="[Replace the text and brackets with a user name or 
           group.]"
        roles="admin" 
        verbs="enterSharedScope"  />
    </authorization>
  </personalization>
</webParts> 

بعد تحميل الصفحة في مستعرض، انقر فوق الزر نطاق تبديل، ولاحظ أن الصفحة تقول الآن نطاق هو المشتركة. انقر فوق الوضع التحرير لتغيير الوضع عرض، انقر فوق قائمة الأفعال تشغيل مرئية عنصر تحكم، ثم حدد تحرير من القائمة. لاحظ أن واجهة مستخدم (واجه مستخدم) لكل منهما ‏‏تحرير تظهر عناصر التحكم. الآن انقر فوق الوضع استعراض للرجوع إلى الاستعراض العادية. إذا كانت الصفحة تقول أنه هو في النطاق المشترك، انقر فوق نطاق تبديل مرة أخرى للتأكد من الصفحة هو في مجال مستخدم. بعد ذلك، اتبع نفس الخطوات لتحرير عنصر التحكم مرة أخرى، ولكن لاحظ أنه الآن في واجهة ‏‏تحرير المستخدم، BehaviorEditorPartعنصر التحكم غير ظاهر. أن هو لأن th هو عنصر التحكم فقط يعمل عند الصفحة هو في مشاركة نطاق إضفاء الطابع الشخصي.

نظام التشغيل 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
إظهار: