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.WebParts الخاصية

Visual Studio 2010

يحصل على مرجع ل كافة WebPartتعقب عناصر التحكم بواسطة WebPartManagerالتحكم الموجودة صفحة ويب.

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

[BrowsableAttribute(false)]
public WebPartCollection WebParts { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.WebParts.WebPartCollection
A WebPartCollection that يحتوي على مراجع إلى a التعيين of WebPart عناصر التحكم.

The WebParts خاصية هو used بواسطة the WebPartManager عنصر تحكم إلى مقطع صوتي الجميع WebPart عناصر التحكم that are contained within WebPartZoneBase zones تشغيل the الصفحة. Although the مجموعة هو read-فقط, you can الوصول individual WebPart عناصر التحكم through the مجموعة و عمل تغييرات إلى them programmatically.

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

It هو possible إلى have a WebPart عنصر تحكم placed تشغيل a الصفحة outside of a WebPartZone منطقة, which نتائج في the عنصر تحكم not being tracked بواسطة the WebPartManager عنصر تحكم أو مشار إليها في its WebParts مجموعة. ومع ذلك، هناك هو قليل السبب لاستخدام WebPartالتحكم خارج منطقة، لأنه ثم تفقد وظيفتها "أجزاء ويب" ويتصرف كعنصر تحكم ملقم عادية.

أي نوع من عناصر التحكم التي يمكن وضعها في منطقة ما، سواء المخصصة WebPartعنصر تحكم كـP.NET قياسية، عنصر تحكم مستخدم أو عنصر تحكم مخصص لخادم، يمكن أن يتم التعامل مع كـ WebPartالتحكم في وقت التشغيل. عندما عنصر تحكم غير WebPartوضع عنصر التحكم في WebPartZoneيلتف المنطقة، في وقت التشغيل ASP.NET عنصر تحكم GenericWebPartالكائنات، حيث يمكن سلوك عنصر التحكم صواب WebPartعنصر التحكم. Therefore, بواسطة using the WebParts خاصية, the WebPartManager control can مقطع صوتي أي نوع of عنصر تحكم الخادم, regardless of whether it derives من the WebPart فئة.

The following تعليمات برمجية مثال demonstrates how إلى استخدم the WebParts خاصية programmatically إلى الوصول individual WebPart عناصر التحكم. Notice that في the declarative ترميز for the ويب الصفحة, within the <asp:webpartzone> عنصر there are الثاني قياسي ASP.NET الخادم عناصر التحكم. Although these do not يورث من the WebPart فئة, because they are في a منطقة they will be wrapped مع a GenericWebPart كائن at تشغيل الوقت, و thus will be مُضمن في the مجموعة مشار إليها بواسطة the WebParts خاصية. You could also إضافة مخصص WebPart عناصر التحكم, مستخدم عناصر التحكم, أو مخصص الخادم عناصر التحكم في this منطقة, و they would be handled the same way.


<%@ 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)
  {
    Label1.Text = "WebPart count:  " +
      WebPartManager1.WebParts.Count.ToString();
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartManager1.WebParts["Calendar1"].ChromeType = 
      PartChromeType.BorderOnly;
  }
</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">
      <!-- Reference the WebPartManager control. -->
    <asp:WebPartManager ID="WebPartManager1" runat="server" />    
    <div>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="WebPart Count" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Hide Calendar Title" 
        OnClick="Button2_Click" />  
      <br />
      <asp:Label ID="Label1" runat="server" text="" />
    </div>
    </form>
</body>
</html>


ملاحظة that for the تعليمات برمجية مثال إلى work, you must إضافة a إعداد في the ويب.config ملف إلى تمكين exporting ويب Parts وصف ملفات. تأكد من وجود ملف ويب.config في نفس الدليل صفحة ويب هذا المثال التعليمات البرمجية. Within the <system.web> مقطع, make sure there هو a <webParts> عنصر مع an enableExport سمة التعيين إلى true, كـ في the following ترميز.

<webParts enableExport="true">

...

</webParts>

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

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