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.

WebPartCollection الفئة

Visual Studio 2010

يحتوي على مجموعة من WebPartعناصر التحكم باستخدام إلى لتتبع وإدارة المجموعات ذات الصلة من عناصر التحكم. و هذه الفئة لا يمكن أن تكون موروثة.

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

public sealed class WebPartCollection : ReadOnlyCollectionBase

WebPartCollection الفئة مجموعة من عناصر التحكم، يستخدم عادة بالقراءة فقط WebPartZoneBaseو WebPartManagerعناصر إلى إدارة مجموعات من WebPartعناصر التحكم.

WebPartManager عنصر تحكم يستخدم WebPartCollectionالكائن الاحتفاظ بقائمة من الجميع WebPartعنصر تحكم s تشغيل صفحة، بينما WebPartZoneBaseعنصر تحكم يستخدم WebPartCollectionالكائن لتعقب WebPartعنصر تحكم s الذي يحتوي تشغيل.

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

WebPartCollection المجموعة تحتوي على كل من WebPartعناصر التحكم والخادم الآخر عناصر التحكم (مثل مستخدم عناصر التحكم مخصصة عناصر التحكم، و ASP.NET عناصر التحكم) التي تم وضعها في WebPartZoneBaseمناطق واستخدامها كجزء من "أجزاء ويب" التطبيقات. في هذه الحالة، على سبيل المثال، إذا كان لديك WebPartZoneمنطقة في الصفحة، وتقوم بتعريفه مخصص الموجودة بداخله WebPartالتحكم و ASP.NET في Calendarعنصر تحكم، سوف تكون كل من عنصري التحكم WebPartCollectionالمشار إليها من قبل مجموعة WebPartsخاصية.

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

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

  • تعليمات برمجية للصفحة في فئة جزئي.

  • الويب الصفحة الذي يحتوي على عناصر التحكم.

  • وصف كيفية مثال يعمل في مستعرض.

الجزء أول من المثال تعليمات برمجية يحتوي على تعليمات برمجية للصفحة في فئة جزئي. ملاحظة التي Button1_Clickإنشاء أسلوب WebPartCollectionكائن يتكون من الجميع WebPartالمشار إليه في عناصر التحكم WebPartManager.WebPartsخاصية، والتي تتضمن الجميع WebPartعناصر التحكم تشغيل الصفحة. الأسلوب بالتكرار عبر الجميع عناصر التحكم، وتبديل كل عنصر تحكم ChromeStateخاصية التي تحدد ما إذا كان التي تتحكم هو عادي أو مصغر.


using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class webpartcollectioncs : System.Web.UI.Page
{
  protected void Button1_Click(object sender, EventArgs e)
  {

    WebPartCollection partCollection = mgr1.WebParts;

    foreach (WebPart part in partCollection)
    {
      if (part.ChromeState != PartChromeState.Minimized)
        part.ChromeState = PartChromeState.Minimized;
      else
        part.ChromeState = PartChromeState.Normal;
    }
  }
  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartCollection partCollection = WebPartZone1.WebParts;

    if (partCollection[0].Title == "My Link List")
      partCollection[0].Title = "Favorite Links";
    else
      partCollection[0].Title = "My Link List";
  }
}


الجزء الثاني من تعليمات برمجية المثال هو صفحة ويب التي تحتوي على عناصر التحكم. لاحظ أن عناصر التحكم التي تم تعريفها في WebPartZone1عناصر تحكم خادم ASP.NET القياسية، ولكن لأن أنها يتم التفاف ك GenericWebPartعناصر التحكم أثناء وقت التشغيل، و GenericWebPartفئة يرث من WebPartفئة، عناصر التحكم تلقائياً معاملة WebPartعناصر تحكم في وقت التشغيل، ولذلك يتم تضمينها في WebPartCollectionالكائن.


<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<!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>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>


بعد تحميل الصفحة في مستعرض وانقر فوق التبديل بين ChromeState زر, loops التعليمة البرمجية في فئة جزئي من خلال WebPartCollectionالكائن والتناوب تصغير عناصر التحكم أو إرجاعها إلى عادي. أو، إذا قمت بالنقر فوق التبديل بين عنوان BulletedList1 بشكل متكرر زر، يتم تم تغييره عنوان لعنصر التحكم العلوي إلى قيم بديلة.

System.Object
  System.Collections.ReadOnlyCollectionBase
    System.Web.UI.WebControls.WebParts.WebPartCollection

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