WebPartManager.GetGenericWebPart(Control) Yöntem

Tanım

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

Sunucu denetimi içeren denetimin GenericWebPart örneğine başvuru alır.

public:
 System::Web::UI::WebControls::WebParts::GenericWebPart ^ GetGenericWebPart(System::Web::UI::Control ^ control);
public System.Web.UI.WebControls.WebParts.GenericWebPart GetGenericWebPart(System.Web.UI.Control control);
member this.GetGenericWebPart : System.Web.UI.Control -> System.Web.UI.WebControls.WebParts.GenericWebPart
Public Function GetGenericWebPart (control As Control) As GenericWebPart

Parametreler

control
Control

içinde bulunan WebPartZoneBase ve çalışma zamanında alt denetimi olarak sarmalanan bir GenericWebPart sunucu denetimi.

Döndürülenler

GenericWebPart

Alt GenericWebPart denetim olarak sarmalayan control bir. yöntemi, içinde nullyoksa control döndürürGenericWebPart.

Özel durumlar

ArgumentNullException

control, null'e eşittir.

Örnekler

Aşağıdaki kod örneği, yönteminin GetGenericWebPart kullanımını gösterir. Kod örneği, bir Calendar bölge içinde bildirilen bir WebPartZone denetim içerir. Button1_Click yöntemi önce denetimin Calendar kimliğini bir etikete yazdırır ve ardından takvimi sarmalayan denetime başvuru almak için GetGenericWebPart yöntemini kullanırGenericWebPart. Denetimin GenericWebPart kimliği ve alt denetiminin kimliği (denetimdir Calendar ) ikinci bir etikete yazdırılır.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  protected void Button1_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h2>Server Control</h2>";
    Label1.Text += "Server Control ID:  " + Calendar1.ID;
    Label2.Text = "<h2>GenericWebPart Control</h2>";
    GenericWebPart part = mgr.GetGenericWebPart(Calendar1);
    if (part != null)
    {
      Label2.Text +=
        "GenericWebPart ID:  " + part.ID + "<br />";
      Label2.Text +=
        "Underlying Control ID: " + part.ChildControl.ID;
    }
  }

</script>

<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="mgr" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Get GenericWebPart"
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" Text="" />
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Label1.Text = "<h2>Server Control</h2>"
    Label1.Text += "Server Control ID:  " + Calendar1.ID
    Label2.Text = "<h2>GenericWebPart Controls</h2>"
    Dim part As GenericWebPart
    part = mgr.GetGenericWebPart(Calendar1)
    If part IsNot Nothing Then
      Label2.Text += _
        "GenericWebPart ID:  " & part.ID & "<br />"
      Label2.Text += _
        "Underlying Control ID: " + part.ChildControl.ID
    End If
    
  End Sub

</script>

<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="mgr" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Get GenericWebPart"
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" Text="" />
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
    </div>
    </form>
</body>
</html>

Açıklamalar

Genel olarak, geliştiricilerin Web Bölümleri uygulamalarına katılmak için WebPartZoneBase bölgelerine yerleştirdiği iki denetim kategorisi vardır: WebPart temel sınıfından devralan WebPart denetimleri ve standart ASP.NET denetimleri, özel denetimler veya kullanıcı denetimleri olabilecek diğer sunucu denetimleri. Bu denetimlerden herhangi biri bir WebPartZoneBase bölgeye yerleştirildiğinde, denetimin WebPart işlevselliğini üstlenir. Bir WebPart denetim doğası gereği bu işlevselliğe sahiptir, ancak diğer tür sunucu denetimleri bunu yapmaz. Diğer sunucu denetimlerinin WebPart bölgesine yerleştirildiğinde WebPartZoneBase denetimleri olarak davranmasını sağlamak ASP.NET bunları bir GenericWebPart denetimiyle sarmalar. GenericWebPart Denetim doğrudan sınıfından WebPart devraldığından, alt denetimlerine gerçek Web Bölümleri özellikleri sağlar.

Genellikle çalışma zamanında, sayfa geliştiricileri bir bölgedeki sunucu denetimlerinden birini içeren denetime GenericWebPart başvuru almak isteyebilir. yöntemi, GetGenericWebPart denetime bir başvuru almalarını GenericWebPart sağlar.

Şunlara uygulanır

Ayrıca bkz.