WebPartManager.GetCurrentWebPartManager(Page) Metode

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

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

WebPartManager yang mereferensikan instans kontrol saat ini pada halaman.

Pengecualian

ArgumentNullException

pageadalah 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.

Berlaku untuk

Lihat juga

ASP.NET Kontrol Komponen Web

Bagikan melalui