WebPartManager.GetCurrentWebPartManager(Page) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengambil referensi ke instans WebPartManager kontrol saat ini pada halaman.
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
Parameter
- page
- Page
Halaman Web yang berisi instans WebPartManager.
Mengembalikan
WebPartManager yang mereferensikan instans kontrol saat ini pada halaman.
Pengecualian
page
adalah null
.
Contoh
Contoh kode berikut menunjukkan cara menggunakan GetCurrentWebPartManager metode . Contohnya memiliki dua bagian: kontrol server kustom, dan halaman Web yang menghosting kontrol.
Kontrol kustom Label menggunakan GetCurrentWebPartManager metode untuk mengambil ID WebPartManager kontrol pada halaman saat ini, lalu menampilkan ID.
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
Contoh kode berikut menyediakan halaman Web yang menghosting kontrol di WebPartZone zona.
<%@ 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>
Setelah Anda memuat halaman di browser, perhatikan bahwa ID kontrol saat ini WebPartManager ditampilkan dalam kontrol kustom Label .
Keterangan
Metode GetCurrentWebPartManager ini berguna dalam konteks di mana Anda ingin mengambil referensi ke kontrol saat ini WebPartManager . Skenario umum di mana ini akan terjadi adalah jika Anda menulis kontrol kustom yang tidak dapat mengetahui selama pengembangan id WebPartManager kontrol di halamannya.
Catatan
Metode GetCurrentWebPartManager ini statis, sehingga Anda dapat memanggilnya secara langsung tanpa memerlukan instans WebPartManager kontrol.
Beberapa kontrol dalam kumpulan kontrol Bagian Web, seperti WebPart kontrol, memiliki WebPartManager properti yang bisa mengambil referensi ke kontrol saat ini WebPartManager . Oleh karena itu, ketika bekerja dengan kontrol seperti itu, Anda harus menggunakan properti ini untuk mengambil referensi.
Jika Anda mengodekan dalam konteks di mana Anda mengetahui ID WebPartManager kontrol, seperti menulis kode sebaris dalam halaman Web, paling sederhana dan paling efisien untuk merujuk langsung ke WebPartManager kontrol dengan menggunakan ID-nya.