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.

WebPartZoneCollection الفئة

Visual Studio 2010

يحتوي على مجموعة للقراءة فقط من WebPartZoneعناصر التحكم.

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

public sealed class WebPartZoneCollection : ReadOnlyCollectionBase

WebPartZoneCollection فئة يحتوي تشغيل المجموعة من WebPartZoneعناصر التحكم الموجودة في "أجزاء ويب" الصفحة. هو يستخدم أساسا بواسطة WebPartManagerالتحكم لتتبع وإدارة الجميع المناطق. WebPartManager عنصر تحكم يحتفظ مرجع إلى مجموعة مناطق تشغيل صفحة في به القراءة فقط Zonesخاصية.

WebPartZoneCollection الفئة هو مفيداً عندما تريد تنفيذ العمليات تشغيل مناطق متعددة أو محتوياتها في نفس الوقت، أو عند الحاجة إلى بحث منطقة معينة وفحص أو تغيير المحتويات الخاصة بها. وعلى الرغم من أن المجموعة من مناطق نفسه هو القراءة فقط وإمكانية تغيير حجم كائن مجموعة نفسه يمكن مواصلة يحصل مراجع إلى مناطق فردية داخل المجموعة وعندما يكون لديك مرجعاً إلى كائن لمنطقة مفردة، يمكنك تغيير قيمة خاصية.

WebPartZoneCollection على فئة المنشئات الثاني. أول واحد، WebPartZoneCollection()، تهيئة مثيل فارغ من جديد ببساطة WebPartZoneCollection. ثانيا واحدة WebPartZoneCollection(ICollection)، تهيئة مجموعة بواسطة تمرير في مجموعة موجودة من مناطق.

WebPartZoneCollection يحتوي على فئة Itemخاصية. تتيح هذه خاصية بتحديد موقع WebPartZoneعنصر تحكم ضمن المجموعة بالتمرير في معرّف السلسلة. المنطقة هو الموجود المطابقة لمعرف سلسلة أحرف إلى القيمة IDخاصية تشغيل WebPartZoneBaseالمنطقة.

WebPartZoneCollection فئة يحتوي أيضا على العديد من الطرق التي تفيد بفحص أو الوصول إلى المحتويات الخاصة بها. Contains أسلوب تحديد ما إذا كان موجود منطقة معينة في مجموعة. CopyTo أسلوب الالنسخ مجموعة إلى صفيفة من WebPartZoneBaseالكائنات. وأخيراً، IndexOfالأسلوب بإرجاع فهرس منطقة معينة داخل مجموعة.

يلي تعليمات برمجية يوضح المثال استخدام WebPartZoneCollectionفئة. تعليمات برمجية المثال يحتوي على ثلاثة أجزاء: مقطعين من تعليمات برمجية، وشرح كيفية تشغيل المثال.

الجزء أول من المثال تعليمات برمجية صفحة ويب التي تحتوي على " ثلاثة WebPartZoneعناصر التحكم، كل منها يحتوي على عنصر تحكم الخادم مفرد. على الرغم من أن عناصر تحكم الملقم الجميع عناصر التحكم كـP.NET القياسية، يمكن للعمل كـ WebPartيتحكم في وقت التشغيل لأن فإنها توضع داخل WebPartZoneالمنطقة.


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

<!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 id="Head1" runat="server">
    <title>WebPartZoneCollection Demo</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <asp:WebPartManager ID="mgr" runat="server" />
    <asp:Table ID="Table1" runat="server">
      <asp:TableRow>
        <asp:TableCell>
          <asp:Label ID="lblZone1" runat="server" 
            Font-Bold="true"
            AssociatedControlID="WebPartZone1">
            WebPartZone1 Contents
          </asp:Label>
          <asp:WebPartZone ID="WebPartZone1" 
            runat="server" Width="230">
            <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>      
            </ZoneTemplate>
          </asp:WebPartZone>
          <div>
          <asp:Label ID="lblZone2" runat="server" 
            Font-Bold="true"
            AssociatedControlID="WebPartZone2">
            WebPartZone2 Contents
          </asp:Label>
          </div>
          <asp:WebPartZone ID="WebPartZone2" 
            runat="server" Width="230">
            <ZoneTemplate>
              <asp:Calendar ID="Calendar1" 
                runat="server" 
                Title="My Calendar" 
                CatalogIconImageUrl="Mine.gif" />
            </ZoneTemplate>
          </asp:WebPartZone> 
        </asp:TableCell>
        <asp:TableCell VerticalAlign="top"> 
          <asp:Label ID="lblZone3" runat="server" 
            Font-Bold="true" 
            AssociatedControlID="WebPartZone3">
            WebPartZone3 Contents
          </asp:Label>
          <asp:WebPartZone ID="WebPartZone3" runat="server">
            <ZoneTemplate>
              <asp:Table runat="server" ID="table2" 
                Title="Employee Extensions">
                <asp:TableHeaderRow>
                  <asp:TableHeaderCell Scope="Column">
                    Employee Name</asp:TableHeaderCell>
                  <asp:TableHeaderCell Scope="Column">
                    Extension</asp:TableHeaderCell>
                </asp:TableHeaderRow>
                <asp:TableRow>
                  <asp:TableCell>Alberts, Amy</asp:TableCell>
                  <asp:TableCell>x9764</asp:TableCell>
                </asp:TableRow>                
                <asp:TableRow>
                  <asp:TableCell>Hanif, Karim</asp:TableCell>
                  <asp:TableCell>x3240</asp:TableCell>
                </asp:TableRow>
                <asp:TableRow>
                  <asp:TableCell>Penor, Lori</asp:TableCell>
                  <asp:TableCell>x4165</asp:TableCell>
                </asp:TableRow>
              </asp:Table>
            </ZoneTemplate>
          </asp:WebPartZone>
        </asp:TableCell>
      </asp:TableRow>
    </asp:Table>
    </div>
    <hr />
    <asp:Table ID="Table3" runat="server">
      <asp:TableRow>
        <asp:TableCell>
          <asp:Button ID="Button1" runat="server" 
            Width ="200" OnClick="Button1_Click" 
            Text="Total Zone Count" />
          <br />
          <asp:Button ID="Button2" runat="server" 
            Width ="200" OnClick="Button2_Click"
            Text="Coll. Contains WebPartZone2" />
          <br />
          <asp:Button ID="Button3" runat="server" 
            Width ="200" OnClick="Button3_Click"
            Text="Zone Names from Array" />
          <br />
          <asp:Button ID="Button4" runat="server" 
            Width ="200" OnClick="Button4_Click"
            Text="WebPartZone1 Index" />  
          <br />
          <asp:Button ID="Button5" runat="server" 
            Width ="200" OnClick="Button5_Click"
            Text="Toggle Verb Render Mode" />
        </asp:TableCell>
        <asp:TableCell HorizontalAlign="right" 
          Width="200" VerticalAlign="top">
          <asp:Label ID="Label1" runat="server" 
            Font-Bold="true" />
        </asp:TableCell>  
      </asp:TableRow>
    </asp:Table>
    </form>
</body>
</html>


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


using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class webpartzonecollection_overview : System.Web.UI.Page
{

  protected void Button1_Click(object sender, EventArgs e)
  {
    Label1.Text = String.Empty;
    Label1.Text = "WebPartZone Count:  " + mgr.Zones.Count;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    Label1.Text = String.Empty;
    Label1.Text = mgr.Zones.Contains(WebPartZone2).ToString();
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = String.Empty;
    WebPartZoneBase[] zoneArray = new WebPartZoneBase[mgr.Zones.Count];
    mgr.Zones.CopyTo(zoneArray, 0);
    Label1.Text = zoneArray[2].ID;
    Label1.Text += ", " + zoneArray[1].ID;
    Label1.Text += ", " + zoneArray[0].ID;
  }

  protected void Button4_Click(object sender, EventArgs e)
  {
    Label1.Text = String.Empty;
    Label1.Text = "WebPartZone1 index:  " + mgr.Zones.IndexOf(WebPartZone1);
  }

  protected void Button5_Click(object sender, EventArgs e)
  {
    Label1.Text = String.Empty;

    WebPartZoneCollection zoneCollection = mgr.Zones;
    foreach (WebPartZone zone in zoneCollection)
    {

      if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
        zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
      else
        zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
    }
  }
}


قم بتحميل الصفحة في المستعرض. ثلاثة WebPartZoneمناطق مرئي مع عناصر تحكم الملقم المتضمنة بها. قريب أسفل الصفحة هي الأزرار متعددة، كل منها توضح بعض جوانب العمل مع WebPartZoneCollectionكائن. انقر فوق كل زر لمعرفة تأثيره تشغيل المناطق ومحتوياتها. إلى عرض تعليمات برمجية المقترنة بكل butإلىn يوضح بعض جوانب WebPartZoneCollectionالكائن، قم بعرض تعليمات برمجية في الملف فئة جزئي المشار إليها أعلاه كالجزء الثاني من هذا المثال تعليمات برمجية.

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

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