WebPartManager.GetCurrentWebPartManager(Page) Yöntem
Tanım
Ö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
Bir WebPartManager sayfadaki denetimin geçerli örneğine başvuran.
Özel durumlar
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.