WebPartManager.CreateWebPart(Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zabalí serverový ovládací prvek, který není ovládacím WebPart prvek s objektem GenericWebPart , aby ovládací prvek mohl mít funkci webových částí.

public:
 virtual System::Web::UI::WebControls::WebParts::GenericWebPart ^ CreateWebPart(System::Web::UI::Control ^ control);

public virtual System.Web.UI.WebControls.WebParts.GenericWebPart CreateWebPart (System.Web.UI.Control control);

abstract member CreateWebPart : System.Web.UI.Control -> System.Web.UI.WebControls.WebParts.GenericWebPart
override this.CreateWebPart : System.Web.UI.Control -> System.Web.UI.WebControls.WebParts.GenericWebPart

Public Overridable Function CreateWebPart (control As Control) As GenericWebPart

Parametry

control: Control

Serverový ovládací prvek, který není ovládacím WebPart prvku.

Návraty

GenericWebPart

Objekt , GenericWebPart který zabalí control a umožní jeho fungování jako skutečný WebPart ovládací prvek.

Příklady

Následující příklad kódu ukazuje použití CreateWebPart metody . V objektu Button2_Click methodCreateWebPart je volána metoda , která před přidáním ovládacího prvku do zóny zabalí Calendar ovládací prvek GenericWebPart s objektem .

<%@ 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 Button2_Click(object sender, EventArgs e)
  {
    WebPartManager mgr = WebPartManager1;
    Calendar cal = new Calendar();
    cal.ID = "cal1";
    GenericWebPart calWebPart = mgr.CreateWebPart(cal);
    mgr.AddWebPart(calWebPart, WebPartZone1, 1);
  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    if (WebPartZone1.WebParts.Count > 1)
    {
      WebPart cal = WebPartZone1.WebParts[1];
      if (cal.Controls[0].GetType().Name == "Calendar" 
        && cal != null)
        WebPartManager1.DeleteWebPart(cal);
    }

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Adding a Server Control</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" 
        runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList  
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Delete Calendar" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Add Calendar" 
        OnClick="Button2_Click" />
    </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 Button2_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    Dim mgr As WebPartManager = WebPartManager1
    Dim cal As New Calendar()
    cal.ID = "cal1"
    Dim calWebPart As GenericWebPart = mgr.CreateWebPart(cal)
    mgr.AddWebPart(calWebPart, WebPartZone1, 1)
  End Sub

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)

    If WebPartZone1.WebParts.Count > 1 Then
      Dim cal As WebPart = WebPartZone1.WebParts(1)
      If cal.Controls(0).GetType().Name = "Calendar" AndAlso _
        cal IsNot Nothing Then
        WebPartManager1.DeleteWebPart(cal)
      End If
    End If
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Adding a Server Control</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" 
        runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList  
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Delete Calendar" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Add Calendar" 
        OnClick="Button2_Click" />
    </div>
    </form>
</body>
</html>

Poznámky

Metoda CreateWebPart je hlavním mechanismem umožňujícím serverovým ovládacím prvkům, které nejsou WebPart ovládacími prvky, převzít stejné funkce jako WebPart ovládací prvek, a tím se plně zapojit do aplikací webových částí. Pomocí této metody vývojáři výrazně rozšíří počet serverových ovládacích prvků, které mohou použít v aplikaci webových částí, protože lze použít prakticky jakýkoli typ serverového ovládacího prvku – standardní ASP.NET ovládací prvky, uživatelské ovládací prvky a vlastní ovládací prvky.

Ovládací WebPartManager prvek používá tuto metodu také ve dvou dalších scénářích k zabalení serverových ovládacích prvků s objektem GenericWebPart . Když uživatelé přidávají serverové ovládací prvky na stránku pomocí ImportCatalogPart ovládacího prvku, pokud importovaný ovládací prvek není WebPart ovládací prvek, CreateWebPart je volána metoda . Pokud jsou serverové ovládací prvky deklarovány ve formátu trvalosti v rámci WebPartZoneBase zóny na webové stránce, CreateWebPart je volána metoda pro všechny ovládací prvky, které nejsou WebPart ovládacími prvky.

Když přidáte serverový ovládací prvek do zóny programově, obvyklým přístupem je použití CreateWebPart metody k zabalení ovládacího prvku s objektem GenericWebPart a následné volání AddWebPart metody pro přidání ovládacího prvku do kolekce všech WebPart ovládacích prvků na stránce, na kterou odkazuje WebParts vlastnost .

Poznámky pro dědice

Tuto metodu lze přepsat tak, aby používala odvozenou GenericWebPart třídu místo základní třídy poskytované se sadou ovládacích prvků webových částí.

Platí pro

Sdílet prostřednictvím