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.

WebPartDisplayMode الفئة

Visual Studio 2010

قم بتعريف مجموعة شائعة من الخصائص لعدة أوضاع العرض التي يمكن لصفحة "أجزاء ويب" Enter الزر.

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

public abstract class WebPartDisplayMode

أجزاء ويب الصفحة يمكن إدخال عدة أوضاع العرض المختلفة. في كل الوضع عرض، تكون بعض عناصر واجهة مستخدم (واجه مستخدم) "أجزاء ويب" أما مخفية أو عرضها، وبعض أنواع التعديلات مستخدم إلى صفحة هي أما ممكنة أو معطلة. WebPartManager عنصر تحكم يحتوي على التطبيق لأوضاع عرض المتوفرة في التعيين "أجزاء ويب" تحكم وإدارة أوضاع عرض الصفحة.

يسرد الجدول التالي حقول التي تمثل في أوضاع عرض متوفر.

وضع العرض

الوصف

BrowseDisplayMode

يعرض عناصر تحكم أجزاء الويب وعناصر واجهة المستخدم في الوضع العادي الذي يعرض به المستخدمون الصفحة.

DesignDisplayMode

عرض عناصر واجهة المستخدم للمنطقة وتتيح للمستخدمين إمكانية سحب "أجزاء ويب" عناصر التحكم لتغيير تخطيط الصفحة.

EditDisplayMode

تعرض خاص ‏‏تحرير عناصر واجهة المستخدم ويقوم بتمكين المستخدمين من ‏‏تحرير عناصر التحكم تشغيل صفحة.

CatalogDisplayMode

عرض عناصر واجهة المستخدم كاتالوج الخاصة وقم بتمكين المستخدمين من إضافة وإزالة الصفحة عناصر التحكم.

ConnectDisplayMode

تعرض الاتصالات خاص عناصر واجهة المستخدم ويقوم بتمكين المستخدمين النهائيين إلى توصيل "أجزاء ويب" عناصر التحكم.

ملاحظات للمسئولين عن الإرث

يمكن للمطورين ينحدر من WebPartDisplayModeالفئة إلى إنشاء cusإلىm أوضاع العرض. لإجراء مخصص WebPartDisplayModeتشغيل "أجزاء ويب" الصفحة، قد تحتاج أيضا إلى ينحدر من WebPartManagerللفئات، وتجاوز به CreateDisplayModesالأسلوب.

توضح الأمثلة تعليمات برمجية التالية استخدام أوضاع عرض تشغيل "أجزاء ويب" مصرحة الصفحة. عرض كافة هذه الأوضاع، كما المطبقة بواسطة "أجزاء ويب" عنصر تحكم التعيين، يتم اشتقاق من WebPartDisplayModeفئة.

وهذا تعليمات برمجية مثال على الرابع أجزاء:

  • A customWebPartعنصر تحكم.

  • صفحة ويب مع منطقة إلى تستضيف عنصر تحكم cusإلىm.

  • عرض عنصر تحكم مستخدم بتمكين المستخدمين من تغيير الأوضاع على صفحة ويب.

  • شرح كيفية عمل الصفحة في مستعرض.

هو الجزء أول من المثال على WebPartعنصر تحكم مخصص TextDisplayWebPart. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . لعرض توضيحي لكلا الأسلوبين التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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 (input.Text != String.Empty)
      {
        this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
        // Clear the input textbox.
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}


الجزء الثاني من مثال التعليمة البرمجية عبارة عن صفحة ويب ASP.NET قياسي يرجع Calendarعنصر تحكم داخل <asp:webpartzone>عنصر، حتى عنصر تحكم هو الملتفة GenericWebPartعنصر تحكم والوظائف أساسى في "أجزاء ويب" في وقت التشغيل. الرجوع أيضا إلى الصفحة TextDisplayWebPartعنصر تحكم داخل <asp:catalogzone>عنصر، والذي يوضح قدرة للمستخدم النهائي للتبديل إلى وضع كتالوج وإضافة عنصر تحكم s للصفحة. The الصفحة also يتضمن an <asp:editorzone> عنصر, which enables users إلى تحرير the عناصر التحكم contained في the <asp:webpartzone> when the الصفحة هو في تحرير الوضع. بالقرب من أعلى الصفحة هي registerموجها لعنصر التحكم المخصص وآخر عنصر تحكم المستخدم.


<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ 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">
<script runat="server">
void Button1_Click(object sender, EventArgs e)
{
  WebPartManager1.DisplayMode = WebPartManager.CatalogDisplayMode;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Web Parts Display Modes</title>
</head>
<body>
  <form id="Form2" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server" BackImageUrl="~/MyImage.gif">
        <zonetemplate>
          <asp:Calendar 
            ID="Calendar1" 
            Runat="server" 
            Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:WebPartZone ID="WebPartZone2" Runat="server">
    </asp:WebPartZone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server">
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" AllowClose="true"/>  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
    <asp:button
      id="button1"
      runat="server"
      text="Catalog Mode"
      OnClick="Button1_Click"
    />
  </form>
</body>
</html>


الجزء الثالث من مثال التعليمة البرمجية هو عنصر تحكم يسمح للمستخدمين بالتبديل بين أوضاع العرض صفحة ويب. حفظ the المصدر تعليمات برمجية for this عنصر تحكم في a ملف named DisplayModeMenuCS.ascx أو DisplayModeMenuVB.ascx (depending تشغيل which اللغة you استخدم for the تعليمات برمجية مثال), و put it في the same الدليل كـ the ويب الصفحة. For المزيد تفاصيل حول عرض modes و a وصف of the المصدر تعليمات برمجية في this عنصر تحكم, see the موضوع الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويب.


<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">

 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }

  }

  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>


عندما تقوم بتحميل الصفحة في مستعرض، يمكنك استخدام الوضع عرض قائمة منسدلة عرض عنصر التحكم للانتقال إلى مختلف الأوضاع. إلى تحرير عناصر التحكم, تحديد تحرير في the إسقاط-أسفل عنصر تحكم القائمة. إلى تحرير a specific عنصر تحكم, expose its الأفعال قائمة بواسطة clicking the arrow في the عنصر تحكم's عنوان bar, و then clicking تحرير في the الأفعال قائمة. When a عنصر تحكم هو في تم تحريره الوضع, the ‏‏تحرير عناصر التحكم تمت الإضافة إلى this الصفحة تمكين you إلى تغيير the تم تحريره عنصر تحكم's المظهر و تخطيط. عندما تنتهي من ذلك، حدد استعراض في القائمة الوضع العرض المنسدلة عنصر تحكم لإرجاع الصفحة إلى طريقة عرض عادية. لإضافة عناصر تحكم إلى الصفحة، بدل إلى كاتالوج الالوضع. لاحظ أنه يمكنك أما استخدام عنصر تحكم القائمة منسدلة الوضع عرض، أو انقر فوق الزر الموجود قريب أسفل الصفحة. التعليمة البرمجية المضمنة ل Button1_Clickأسلوب يوضح كيف إلى تغيير أوضاع عرض برمجياً. عندما تكون في الوضع كتالوج، يمكنك إضافة مخصصة TextDisplayWebPartعنصر تحكم للصفحة.

System.Object
  System.Web.UI.WebControls.WebParts.WebPartDisplayMode

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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
إظهار: