WebPartManager.WebParts Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 program aracılığıyla ö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. Bu bölgeye özel WebPart denetimler, kullanıcı denetimleri veya özel sunucu denetimleri de ekleyebilirsiniz ve bunlar 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 değiştirerek başlıkla değil yalnızca kenarlıkla işlenmesini sağlar.

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.

Not

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

Özel WebPart denetim, standart ASP.NET denetimi, kullanıcı denetimi veya özel sunucu denetimi gibi bir bölgeye yerleştirilebilen her denetim türü, çalışma zamanında denetim olarak WebPart kabul edilebilir. 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ğini kullanarak 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

Aracılığıyla paylaş