次の方法で共有


WebPartZoneBase.WebParts プロパティ

定義

ゾーン内に含まれる Web パーツ コントロールのコレクションを取得します。

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

プロパティ値

ゾーン内のすべての Web パーツ コントロールへの参照を含む WebPartCollection

属性

次のコード例では、WebPartZone コントロールで WebParts プロパティをプログラムで使用する方法を示します。 分離コード ソース ファイルや、このコードのゾーンを含む .aspx ページなど、完全なコード例については、 WebPartZoneBase クラスの概要を参照してください。

次のコード例では、 WebParts プロパティにプログラムでアクセスし、 WebPartZone1に含まれるコントロールの一覧を表示します。 ブラウザーにページを読み込んだ後、[ WebPartZone1 WebParts の一覧表示] というラベルの付いたボタンをクリックします。 コントロールの ID と種類が表示されます。

protected void Button3_Click(object sender, EventArgs e)
{
  StringBuilder builder = new StringBuilder();
  builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
  foreach (WebPart part in WebPartZone1.WebParts)
  {
    builder.AppendLine("ID: " + part.ID 
                        + "; Type:  " + part.GetType() 
                        + @"<br />");
  }
  Label2.Text = builder.ToString();
  Label2.Visible = true;
}
Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs) 
  Dim builder As New StringBuilder()
  builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
  Dim part As WebPart
  For Each part In  WebPartZone1.WebParts
    builder.AppendLine("ID: " + part.ID + "; Type: " _
                        + part.GetType().ToString() _
                        + "<br />")
  Next part
  Label2.Text = builder.ToString()
  Label2.Visible = True
End Sub

注釈

WebParts プロパティには、WebPart クラスから直接継承するコントロールへの参照、およびゾーン内の他の ASP.NET サーバー コントロールまたはカスタム コントロールを含めることができます。 Web パーツ コントロール セットは、実行時に WebPart コントロールではないコントロールを GenericWebPart コントロールとして動的にラップします。このメカニズムを使用すると、すべての種類の ASP.NET コントロールを Web パーツ コントロールとして使用できます。

適用対象

こちらもご覧ください