Aracılığıyla paylaş

WebPartManager.WebParts Özellik

Tanım

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

Web sayfasındaki denetim tarafından WebPartManager izlenen tüm WebPart denetimlere başvuru alır.

public:
 property System::Web::UI::WebControls::WebParts::WebPartCollection ^ WebParts { System::Web::UI::WebControls::WebParts::WebPartCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartCollection WebParts { get; }
[<System.ComponentModel.Browsable(false)>]
member this.WebParts : System.Web.UI.WebControls.WebParts.WebPartCollection
Public ReadOnly Property WebParts As WebPartCollection

Özellik Değeri

WebPartCollection

Bir WebPartCollection denetim kümesine WebPart başvurular içeren bir.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, tek tek WebPart denetimlere erişmek için programlama yoluyla özelliğinin nasıl kullanılacağını WebParts gösterir. Web sayfasının bildirim temelli işaretlemesinde, öğesinin <asp:webpartzone> içinde iki standart ASP.NET sunucu denetimi olduğuna dikkat edin. Bunlar sınıfından WebPart devralmasa da, bir bölgede oldukları için çalışma zamanında bir GenericWebPart nesneyle sarmalanırlar ve bu nedenle özelliği tarafından başvurulan koleksiyona WebParts dahil edilirler. Ayrıca bu bölgeye özel WebPart denetimler, kullanıcı denetimleri veya özel sunucu denetimleri ekleyebilirsiniz ve bunlar da aynı şekilde işlenir.

<%@ 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 = "WebPart count:  " +
      WebPartManager1.WebParts.Count.ToString();
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartManager1.WebParts["Calendar1"].ChromeType = 
      PartChromeType.BorderOnly;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
    <asp:WebPartManager ID="WebPartManager1" runat="server" />    
    <div>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <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>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="WebPart Count" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Hide Calendar Title" 
        OnClick="Button2_Click" />  
      <br />
      <asp:Label ID="Label1" 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 = "WebPart count:  " & _
      WebPartManager1.WebParts.Count.ToString()
  End Sub

  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    WebPartManager1.WebParts("Calendar1").ChromeType = _
      PartChromeType.BorderOnly

  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
    <asp:WebPartManager ID="WebPartManager1" runat="server" />    
    <div>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <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>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="WebPart Count" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Hide Calendar Title" 
        OnClick="Button2_Click" />  
      <br />
      <asp:Label ID="Label1" runat="server" text="" />
    </div>
    </form>
</body>
</html>

Kod örneğinin çalışması için Web Bölümleri açıklama dosyalarını dışarı aktarmayı etkinleştirmek için Web.config dosyasına bir ayar eklemeniz gerektiğini unutmayın. Bu kod örneğinin Web sayfasıyla aynı dizinde bir Web.config dosyanız olduğundan emin olun. <system.web> bölümünde, aşağıdaki işaretlemede olduğu gibi özniteliği olarak ayarlanmış truebir enableExport öğe olduğundan emin olun<webParts>.

<webParts enableExport="true">

...

</webParts>

Sayfayı bir tarayıcıya yükledikten sonra Web Bölümü Sayısı düğmesine tıklarsanız kod, koleksiyondaki denetimlerin sayısını döndürmek için özelliğini kullanır WebParts . Takvim Başlığını Gizle düğmesine tıklarsanız, kod takvimi başlıkla değil yalnızca kenarlıkla işlenmek üzere değiştirir.

Açıklamalar

WebParts özelliği, sayfadaki bölgelerin WebPartManager içinde WebPartZoneBase yer alan tüm WebPart denetimleri izlemek için denetim tarafından kullanılır. Koleksiyon salt okunur olsa da, koleksiyon aracılığıyla tek tek WebPart denetimlere erişebilir ve program aracılığıyla bu denetimlerde değişiklik yapabilirsiniz.

Uyarı

Bir denetimin bölgenin dışındaki WebPartZone bir sayfaya yerleştirilmesi mümkündür WebPart ve bu da denetimin denetim tarafından izlenmediğine WebPartManager veya koleksiyonunda başvurulmamasıyla WebParts sonuçlanır. Ancak, daha sonra Web Bölümleri işlevselliğini kaybettiğinden ve normal bir sunucu denetimi olarak davrandığından, bölge dışında bir denetim kullanmak WebPart için çok az neden vardır.

Özel WebPart denetim, standart ASP.NET denetimi, kullanıcı denetimi veya özel sunucu denetimi gibi bir bölgeye yerleştirilebilen herhangi bir denetim türü, çalışma zamanında denetim olarak WebPart ele alınabilir. Denetim olmayan bir WebPart denetim bir WebPartZone bölgeye yerleştirildiğinde, çalışma zamanında ASP.NET denetimi bir GenericWebPart nesneyle sarmalar, böylece denetim gerçek WebPart bir denetim gibi davranabilir. Bu nedenle, özelliği kullanılarak WebParts denetim, sınıfından WebPartManager türetilip türetmediğine WebPart bakılmaksızın her tür sunucu denetimini izleyebilir.

Şunlara uygulanır