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.GetCurrentWebPartManager أسلوب

Visual Studio 2010

Retrieves a مرجع إلى the الحالي مثيل of the WebPartManager عنصر تحكم تشغيل a الصفحة.

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

public static WebPartManager GetCurrentWebPartManager(
	Page page
)

المعلمات

page
النوع: System.Web.UI.Page
صفحة ويب التي تحتوي على مثيل WebPartManager.

القيمة المُرجعة

النوع: System.Web.UI.WebControls.WebParts.WebPartManager
A WebPartManager that مراجع the الحالي مثيل of the عنصر تحكم تشغيل a الصفحة.

استثناء:شرط
ArgumentNullException

page هو null.

The GetCurrentWebPartManager أسلوب هو useful في contexts الموقع you want إلى retrieve a مرجع إلى the الحالي WebPartManager عنصر تحكم. A عام السيناريو الموقع this would occur هو if you are writing a مخصص عنصر تحكم that cannot know during development what the المعرف of the WebPartManager عنصر تحكم تشغيل its الصفحة will be.

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

The GetCurrentWebPartManager أسلوب هو ثابت, so you can يتصل it directly without needing an مثيل of a WebPartManager عنصر تحكم.

Some عناصر التحكم في the عنصر تحكم أجزاء ويب التعيين, such كـ WebPart عناصر التحكم, have a WebPartManager خاصية that can retrieve a مرجع إلى the الحالي WebPartManager control. Hence, when working مع such عناصر التحكم, you should استخدم this خاصية إلى retrieve a مرجع.

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

يوضح المثال تعليمات برمجية التالي كيفية إلى تستخدم في GetCurrentWebPartManagerالأسلوب. The مثال has الثاني parts: عنصر تحكم ملقم مخصص، صفحة ويب الذي يستضيف عنصر التحكم.

The مخصص Label عنصر تحكم uses the GetCurrentWebPartManager أسلوب إلى retrieve the المعرف of the WebPartManager عنصر تحكم تشغيل the الحالي الصفحة, و then displays the المعرف.


namespace Samples.AspNet.CS.Controls
{
  using System;
  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;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyManagerIDLabel : Label
  {

    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      this.Text = 
        WebPartManager.GetCurrentWebPartManager(Page).ID;
    }

  }

}


The following تعليمات برمجية مثال provides the ويب الصفحة that hosts the عنصر تحكم في a WebPartZone منطقة.


<%@ Page Language="C#" %>
<%@ Register 
    Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="aspSample"%>

<!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="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:MyManagerIDLabel ID="mgrID" runat="server" 
            Title="Manager ID Label" 
            Description="Displays the ID of the current WebPartManger."/>
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    </form>
</body>
</html>


بعد you تحميل the الصفحة في a مستعرض, notice that the المعرف of the الحالي WebPartManager عنصر تحكم هو displayed within the مخصص Label عنصر تحكم.

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