CatalogPartCollection.IndexOf メソッド

.NET Framework クラス ライブラリ リファレンス

CatalogPartCollection.IndexOf メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コレクションの特定のメンバの位置を返します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Function IndexOf ( _
    catalogPart As CatalogPart _
) As Integer

Visual Basic (使用法)

Dim instance As CatalogPartCollection
Dim catalogPart As CatalogPart
Dim returnValue As Integer

returnValue = instance.IndexOf(catalogPart)

C#

public int IndexOf (
    CatalogPart catalogPart
)

C++

public:
int IndexOf (
    CatalogPart^ catalogPart
)

J#

public int IndexOf (
    CatalogPart catalogPart
)

JScript

public function IndexOf (
    catalogPart : CatalogPart
) : int

パラメータ

catalogPart

コレクションのメンバである CatalogPart。

戻り値
CatalogPartCollection のメンバである CatalogPart。

解説

IndexOf メソッドは、Web パーツ ページに複数の CatalogPart コントロールが存在しており、コレクションの特定のコントロールを探す必要があるときに役立ちます。

使用例

CatalogPartCollection コレクションのメンバの位置を、その IndexOf プロパティを使用して確認する方法を次のコード例に示します。例の実行に必要なコード全体については、CatalogPartCollection クラスの概要のトピックで「例」を参照してください。

Button1_Click メソッド内のコードは、myParts という名前の新しい CatalogPartCollection オブジェクトを作成します。このメソッドは、IndexOf プロパティを使用して PageCatalogPart コントロールの位置を取得し、そのコントロールのプロパティ値を変更します。

Visual Basic

Protected Sub Button1_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) 
    Dim list As New ArrayList(2)
    list.Add(PageCatalogPart1)
    list.Add(DeclarativeCatalogPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New CatalogPartCollection(list)
    Dim catalog As CatalogPart
    For Each catalog In
  myParts
        catalog.Description = "My " + catalog.DisplayTitle
    Next catalog
    
    ' Use the IndexOf property to locate a CatalogPart control.
    Dim PageCatalogPartIndex As Integer
 = _
      myParts.IndexOf(PageCatalogPart1)
    myParts(PageCatalogPartIndex).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if a CatalogPart control exists.
    If myParts.Contains(PageCatalogPart1) Then
        Dim closedWebPart As WebPart = Nothing
        Dim descriptions As WebPartDescriptionCollection
 = _
          PageCatalogPart1.GetAvailableWebPartDescriptions()
        If descriptions.Count > 0 Then
            closedWebPart = PageCatalogPart1.GetWebPart(descriptions(0))
            closedWebPart.AllowClose = False
        End If
    End If
    
    ' Use indexers to display the details of the CatalogPart controls.
    Label1.Text = String.Empty
    Label1.Text = _
      "<h3>PageCatalogPart Details</h3>"
 & _
      "ID: " & myParts(0).ID + "<br
 />" & _
      "Count: " & myParts(0).GetAvailableWebPartDescriptions().Count
    Label1.Text += _
      "<h3>DeclarativeCatalogPart Details</h3>"
 & _
      "ID: " & myParts("DeclarativeCatalogPart1").ID
 & "<br />" & _
      "Count: " & myParts("DeclarativeCatalogPart1")
 _
        .GetAvailableWebPartDescriptions().Count

End Sub 

C#

protected void Button1_Click(object sender,
 EventArgs e)
{
  ArrayList list = new ArrayList(2);
  list.Add(PageCatalogPart1);
  list.Add(DeclarativeCatalogPart1);
  // Pass an ICollection object to the constructor.
  CatalogPartCollection myParts = new CatalogPartCollection(list);
  foreach (CatalogPart catalog in myParts)
  {
    catalog.Description = "My " + catalog.DisplayTitle;
  }

  // Use the IndexOf property to locate a CatalogPart control.
  int PageCatalogPartIndex = myParts.IndexOf(PageCatalogPart1);
  myParts[PageCatalogPartIndex].ChromeType = PartChromeType.TitleOnly;

  // Use the Contains method to see if a CatalogPart control exists.
  if (myParts.Contains(PageCatalogPart1))
  {
    WebPart closedWebPart = null;
    WebPartDescriptionCollection descriptions = PageCatalogPart1.GetAvailableWebPartDescriptions();
    if (descriptions.Count > 0)
    {
      closedWebPart = PageCatalogPart1.GetWebPart(descriptions[0]);
      closedWebPart.AllowClose = false;
    }
  }
  
  // Use indexers to display the details of the CatalogPart controls.
  Label1.Text = String.Empty;
  Label1.Text =
    "<h3>PageCatalogPart Details</h3>" +
    "ID: " + myParts[0].ID + "<br />" +
    "Count: " + myParts[0].GetAvailableWebPartDescriptions().Count;
  Label1.Text += 
    "<h3>DeclarativeCatalogPart Details</h3>" +
    "ID: " + myParts["DeclarativeCatalogPart1"].ID + "<br
 />" +
    "Count: " + myParts["DeclarativeCatalogPart1"].GetAvailableWebPartDescriptions().Count;
}

ブラウザでページを読み込んだ後、[Display Mode] ドロップダウン リスト コントロールで [カタログ] を選択することにより、ページをカタログ モードに切り替えることができます。[Display CatalogPart Properties] をクリックすると、CatalogPartCollection オブジェクトにアクセスします。さらに、格納されている CatalogPart コントロールの特定のプロパティが表示されます。[ページ カタログ] リンクをクリックして、PageCatalogPart コントロールの内容を表示します。このコントロールはタイトルだけを持ち、境界線はありません。これは、このコントロールの ChromeType プロパティ値が、そのコントロールを取得する IndexOf プロパティを使用するコード内で、TitleOnly に変更されたためです。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CatalogPartCollection クラス
CatalogPartCollection メンバ
System.Web.UI.WebControls.WebParts 名前空間
IndexOf
その他の技術情報
ASP.NET Web パーツ ページ