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.

WebPartDisplayModeCollection الفئة

Visual Studio 2010

يحتوي على مجموعة من WebPartDisplayModeالكائنات. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class WebPartDisplayModeCollection : CollectionBase

WebPartDisplayModeCollection الفئة هو لتحتوي على مجموعة من WebPartDisplayModeالكائنات. هو يستخدمها أساسا WebPartManagerعنصر التحكم لإدارة مجموعات من WebPartDisplayModeالكائنات.

الوضع dهوplay هو خاص عرضه من صفحة ويب التي تظهر عند هو تعيين الالوضع dهوplay الحالية تشغيل WebPartManager.DisplayModeخاصية. أوضاع العرض المستخدمة في تعيين لإنشاء صفحة "أجزاء ويب" عنصر التحكم طرق العرض في أي من المستخدمين يمكن تنفيذ مهام معينة، مثل عناصر تحكم التحرير أو إعادة ترتيب تخطيط الصفحة. WebPartManager عنصر تحكم تعريف أوضاع عرض المتعددة، بما في ذلك BrowseDisplayMode، DesignDisplayMode، EditDisplayMode، CatalogDisplayMode، و ConnectDisplayMode. مجموعة الأوضاع dهوplay هو المشار إليه بواسطة WebPartManager.DisplayModesخاصية.

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

WebPartManager عنصر تحكم يحتفظ مقطع صوتي لأوضاع عرض متوفر تشغيل صفحة مع به SupportedDisplayModesخاصية. تشير هذه خاصية WebPartDisplayModeCollectionكائن الذي يحتوي على الجميع عرض المعتمدة أوضاع.

WebPartDisplayModeCollection فئة لا يحتوي الدالة الإنشائية مكشوفة، حتى تتمكن من إنشاء المثيل الجديد من it. إذا قمت بإنشاء مخصص WebPartDisplayModeالكائن وتريد أن يكون جزءا من مجموعة أوضاع عرض المعتمدة في WebPartManagerعنصر التحكم، يجب أن يورث من WebPartManagerالفئة، يمنع CreateDisplayModesالأسلوب، استدعاء الأسلوب الأساسي لإنشاء المجموعة،، ثم إضافة أية أوضاع عرض المخصص للمجموعة باستخدام به Addالأسلوب.

WebPartDisplayModeCollection على فئة الثاني الخصائص العامة. IsReadOnly الخاصية هي خاصية للقراءة فقط التي تشير إلى ما إذا كان مجموعة هو للللقراءة فقط. overloaded Itemتوفر خاصية الوصول إلى الأعضاء مجموعة.

The WebPartDisplayModeCollection فئة also has several وظائف. Add الأسلوب، ذكر مسبقاً، من إلى إضافة WebPartDisplayModeالكائنات إلى مجموعة. Contains أسلوب تحديد ما إذا كانت معينة الوضع عرض موجود في مجموعة. CopyTo أسلوب الالنسخ مجموعة إلى صفيفة من الكائنات. IndexOf أسلوب إرجاع فهرس الوضع عرض معينة داخل مجموعة. وأخيراً، Insertالأسلوب من إلى قم بإدراج كائن الوضع عرض في فهرس معينة في مجموعة.

يلي تعليمات برمجية يوضح المثال العمل في WebPartDisplayModeCollectionفئة. النقطة الأساسية هو الذي يجب أن يورث من WebPartManagerالفئة وتجاوز CreateDisplayModesأسلوب إضافة مخصص WebPartDisplayModeالكائن إلى WebPartDisplayModeCollectionمجموعة تم إنشاؤها بواسطة WebPartManagerعنصر التحكم.

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

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

  • A ويب الصفحة that hosts the غير ذلك عناصر التحكم.

  • أ عنصر تحكم المستخدم التي توجد في WebPartZoneمنطقة على صفحة ويب، وتمكنك من إدخال نص أو عرضه في التسمية.

  • A المصدر ‏‏رمز الملف that يحتوي على الثاني عناصر التحكم. واحد هو مخصصة WebPartManagerعنصر التحكم؛ والآخر هو مخصص WebPartDisplayModeالكائن المراد إضافتها إلى الصفحة الافتراضية dهوplay الأوضاع.

  • شرح كيفية مثال يعمل.

رمز المصدر للجزء أول من المثال تعليمات برمجية، عنصر تحكم مستخدم التي تسمح لك بتغيير أوضاع عرض، يأتي من موضوع آخر. على سبيل المثال تعليمات برمجية للعمل، تحتاج إلى الحصول على ملف.ascx لعنصر تحكم مستخدم من الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويبموضوع، ومكان الملف في نفس المجلد مثل الصفحة.aspx في هذا المثال تعليمات برمجية.

الجزء الثاني من المثال صفحة ويب. يحتوي على عمودين WebPartZoneعنصر تحكم s، كل من مستخدم عنصر تحكم s والمخصصة WebPartManagerعنصر تحكم. لاحظ Registerتوجيهات في أعلى الصفحة الإشارة إلى عناصر التحكم مستخدم و مساحة الاسم لعناصر التحكم المترجمة.


<%@ Page Language="C#" %>
<%@ Register Src="TextDisplaycs.ascx" 
    TagName="TextDisplay" 
    TagPrefix="uc2" %>
<%@ Register Src="DisplayModeMenuCS.ascx" 
    TagName="DisplayModeMenuCS" 
    TagPrefix="uc1" %>
<%@ Register Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="sample" 
    Assembly="CustomDisplayModeCS"  %>

<!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">
    <uc1:DisplayModeMenuCS id="menu1" runat="server" />
    <div>
    <sample:NewWebPartManager runat="server" ID="wpgm1" />
    <br />
    <table style="width: 100%">
      <tr valign="top" align="center" >
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone1" runat="server">
            <ZoneTemplate>
              <uc2:TextDisplay ID="TextDisplay1" runat="server" />
            </ZoneTemplate>
          </asp:WebPartZone>
        </td>
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone2" runat="server" />
        </td>
      </tr>
    </table>
    <br />
    </div>
    </form>
</body>
</html>


الجزء الثالث من المثال هو عنصر تحكم مستخدم للنص لإدخال و dهوplaying. لاحظ أن يستخدم MultiViewعنصر تحكم لإنشاء طرق عرض متعددة لواجهة مستخدم (واجه المستخدم). يتم عرض طريقة عرض واحدة زر، أخرى دون. لاحظ أنه في تم OnPreRenderالأسلوب، التعليمة البرمجية بالتحقق لمعرفة ما إذا كانت الصفحة موجود حاليا في الوضع عرض المخصصة، ولذلك، فإنه يعرض طريقة عرض عنصر تحكم مستخدم، والذي يتضمن الأول زر. إذا لم تكن الصفحة في الوضع عرض المخصص (على سبيل المثال، إذا كانت الصفحة في الوضع الاستعراض أو التصميم)، زر مخفياً.

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

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


<%@ Control Language="C#" %>
<%@ Import Namespace="Samples.AspNet.CS.Controls" %>

<script runat="server">
  private string textContent;

  [Personalizable]
  public string TextContent
  {
    get { return textContent; }
    set { textContent = value; }
  }

  protected override void OnPreRender(EventArgs e)
  {
    Label1.Text = this.textContent;
    int viewIndex = 0;

    WebPartManager wpmg = 
      WebPartManager.GetCurrentWebPartManager(this.Page);
    NewWebPartManager myNewWpmg = wpmg as NewWebPartManager;
    if (myNewWpmg != null)
    {
      WebPartDisplayMode mode = 
        myNewWpmg.SupportedDisplayModes[myNewWpmg.InLineEditDisplayMode.Name];
      if (mode != null && myNewWpmg.DisplayMode == mode)
      {
        viewIndex = 1;
      }
    }
    this.MultiView1.ActiveViewIndex = viewIndex;

  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    this.TextContent = TextBox1.Text;

    WebPartManager wpmg = 
      WebPartManager.GetCurrentWebPartManager(this.Page);
    WebPartDisplayMode mode = 
      wpmg.SupportedDisplayModes[WebPartManager.BrowseDisplayMode.Name];
    if (mode != null)
      wpmg.DisplayMode = mode;
  }

</script>
<asp:MultiView ID="MultiView1" runat="server">
    <asp:View ID="View1" runat="server">
        <asp:Label ID="Label1" runat="server" Text="Label" />
    </asp:View>
    <asp:View ID="View2" runat="server">
        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" OnClick="Button1_Click" 
          runat="server" Text="Button" />
    </asp:View>
</asp:MultiView>


الجزء الرابع من المثال هو الملف المصدر للاثنين مخصص الفئات. لاحظ أنه cusإلىm WebPartManagerتجاوزات لفئة CreateDisplayModesالأسلوب، قم باستدعاء الأسلوب الأساسي إلى إضافة الجميع أوضاع العرض الافتراضي ويقوم بإضافة الوضع العرض cusإلىm. The custom display mode فئة, InLineEditDisplayMode, simply inherits from WebPartDisplayMode, sets the name of the display mode in the الدالة الإنشائية, and overrides a رقم of the الأساس خصائص إلى establish the characteristics of the custom display.

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


using System;
using System.Collections.Generic;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Web.UI;
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 NewWebPartManager : WebPartManager 
  {
    private static readonly WebPartDisplayMode _inLineEditDisplayMode =
      new InlineWebPartEditDisplayMode();

    public NewWebPartManager() {}

    protected override WebPartDisplayModeCollection CreateDisplayModes() 
    {
      WebPartDisplayModeCollection displayModes = 
        base.CreateDisplayModes();
      displayModes.Add(_inLineEditDisplayMode);
      return displayModes;
    }

    public WebPartDisplayMode InLineEditDisplayMode
    {
      get { return _inLineEditDisplayMode; }
    }

    private sealed class InlineWebPartEditDisplayMode : WebPartDisplayMode
    {
      public InlineWebPartEditDisplayMode()
        : base("Inline Edit Display")
      {
      }
      public override bool AllowPageDesign
      {
        get { return true; }
      }
      public override bool RequiresPersonalization
      {
        get { return true; }
      }
      public override bool ShowHiddenWebParts
      {
        get { return false; }
      }
      public override bool AssociatedWithToolZone
      {
        get { return false; }
      }
      public override bool IsEnabled(WebPartManager webPartManager)
      {
        return true;
      }
    }

  }

}


إلى تشغيل مثال التعليمة البرمجية، قم بتحميل الصفحة في مستعرض. لاحظ أنه الصفحة هو حاليا في الوضع الاستعراض، لا يوجد زر هو vهوible. الوضع العرض المنسدلة استخدام قائمة التحكم بتغيير الصفحة لالوضع عرض تحرير مضمن ولاحظ أنه الآن زر مرئي في عنصر تحكم مستخدم أقل. قم بإضافة بعض نص، ثم انقر فوق زر بتحديث عنصر التحكم. لاحظ أنه dهوplay الصفحة هو إرجاع لاستعراض الوضع، ونص الذي أدخلته هو dهوplayed الآن، وهو الزر هو المخفية مرة أخرى لأن الصفحة هو ليس في وضع "التصنيع" dهوplay المخصصة.

System.Object
  System.Collections.CollectionBase
    System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection

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