Aracılığıyla paylaş

WebPartManager.GetCurrentWebPartManager(Page) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Sayfadaki denetimin geçerli örneğine WebPartManager başvuru alır.

public:
 static System::Web::UI::WebControls::WebParts::WebPartManager ^ GetCurrentWebPartManager(System::Web::UI::Page ^ page);
public static System.Web.UI.WebControls.WebParts.WebPartManager GetCurrentWebPartManager (System.Web.UI.Page page);
static member GetCurrentWebPartManager : System.Web.UI.Page -> System.Web.UI.WebControls.WebParts.WebPartManager
Public Shared Function GetCurrentWebPartManager (page As Page) As WebPartManager

Parametreler

page
Page

örneğini içeren WebPartManagerWeb sayfası.

Döndürülenler

WebPartManager

Bir WebPartManager sayfadaki denetimin geçerli örneğine başvuran.

Özel durumlar

ArgumentNullException

page, null değeridir.

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir GetCurrentWebPartManager . Örnekte iki bölüm vardır: özel bir sunucu denetimi ve denetimi barındıran bir Web sayfası.

Özel Label denetim, geçerli sayfadaki denetimin WebPartManager kimliğini almak için yöntemini kullanır GetCurrentWebPartManager ve ardından kimliği görüntüler.

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;
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyManagerIDLabel

    Inherits Label

    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)

      EnsureChildControls()
      Me.Text = _
        WebPartManager.GetCurrentWebPartManager(Page).ID

    End Sub

  End Class

End Namespace

Aşağıdaki kod örneği, denetimi bir WebPartZone bölgede barındıran Web sayfasını sağlar.

<%@ 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>

<%@ Page Language="vb" %>
<%@ Register 
    Namespace="Samples.AspNet.VB.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 id="Head1" 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>

Sayfayı bir tarayıcıda yükledikten sonra, geçerli WebPartManager denetimin kimliğinin özel Label denetim içinde görüntülendiğine dikkat edin.

Açıklamalar

GetCurrentWebPartManager yöntemi, geçerli WebPartManager denetime başvuru almak istediğiniz bağlamlarda kullanışlıdır. Geliştirme sırasında sayfadaki denetimin kimliğinin WebPartManager ne olacağını bilemeyecek özel bir denetim yazıyorsanız, bunun oluşacağı yaygın bir senaryodur.

Not

GetCurrentWebPartManager yöntemi statiktir, bu nedenle bir denetimin WebPartManager örneğine gerek kalmadan doğrudan çağırabilirsiniz.

Web Bölümleri denetim kümesindeki denetimler gibi WebPart bazı denetimlerin geçerli WebPartManager denetime başvuru alabilen bir özelliği vardırWebPartManager. Bu nedenle, bu tür denetimlerle çalışırken bir başvuru almak için bu özelliği kullanmanız gerekir.

Web sayfasında satır içi kod yazma gibi denetimin WebPartManager kimliğini bildiğiniz bir bağlamda kodlama gerçekleştiriyorsanız, denetimin kimliğini kullanarak doğrudan denetime WebPartManager başvurmak en basit ve en verimli yöntemdir.

Şunlara uygulanır

Ayrıca bkz.