WebPartManager.GetCurrentWebPartManager(Page) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 . Örneğin iki bölümü vardır: özel 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ıya 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 sayfasındaki 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 statik olduğundan, bir denetimin WebPartManager örneğine gerek kalmadan doğrudan çağırabilirsiniz.

denetimler gibi WebPart Web Bölümleri denetim kümesindeki 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 kod yazıyorsanız, denetimin kimliğini kullanarak doğrudan denetime WebPartManager başvurmak en basit ve en verimli yöntemdir.

Şunlara uygulanır

Ayrıca bkz.

ASP.NET Web Bölümleri Denetimleri

Share via