Share via

WebPartManager.GetGenericWebPart(Control) Yöntem

  • Başvuru

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 WebPartZoneBase bulunan ve çalışma zamanında öğesinin alt denetimi olarak sarmalanan bir GenericWebPart sunucu denetimi.

Döndürülenler

GenericWebPart

Alt GenericWebPart denetim olarak sarmalayan control bir. yöntemi bir içinde GenericWebPartyer almadıysa control döndürürnull.

Özel durumlar

ArgumentNullException

control, null değeridir.

Ö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 GenericWebPart yöntemini kullanırGetGenericWebPart. Denetimin GenericWebPart kimliği ve alt denetiminin kimliği (denetimdir Calendar ) her ikisi de 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 uygulamalara katılmak için bölgelere yerleştirdiği WebPartZoneBase iki denetim kategorisi vardır: WebPart temel sınıftan WebPart devralan denetimler 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 denetimin doğası gereği bu işleve sahiptir, ancak diğer sunucu denetimi türleri bunu yapmaz. Diğer sunucu denetimlerinin bir WebPartZoneBase bölgeye yerleştirildiğinde denetim olarak WebPart davranmasını sağlamak için, ASP.NET bunları bir GenericWebPart denetimle sarmalar. GenericWebPart Denetim doğrudan sınıfından WebPart devraldığından, alt denetimlerine doğru 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 GenericWebPart almalarını sağlar.

Şunlara uygulanır

Ayrıca bkz.