ControlCollection.IndexOf メソッド

コレクション内の指定した Control オブジェクトのインデックスを取得します。

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

構文

'宣言
Public Overridable Function IndexOf ( _
    value As Control _
) As Integer
'使用
Dim instance As ControlCollection
Dim value As Control
Dim returnValue As Integer

returnValue = instance.IndexOf(value)

public virtual int IndexOf (
    Control value
)

public:
virtual int IndexOf (
    Control^ value
)

public int IndexOf (
    Control value
)

public function IndexOf (
    value : Control
) : int

適用できません。

パラメータ

• value
  インデックスを返す対象となる Control。

戻り値

指定したサーバー コントロールのインデックス。サーバー コントロールが現在コレクションのメンバではない場合は -1 が返されます。

解説

このメソッドを使用して、ControlCollection オブジェクト内の指定したサーバー コントロールのインデックス位置を確認します。

使用例

IndexOf メソッドを使用して、myLiteralControl コントロールのインデックス位置を、myButton という名前の Button コントロールの ControlCollection コレクションに書き込むコード例を次に示します。

' Create a LiteralControl and use the Add method to add it
' to a button's ControlCollection, then use the AddAt method
' to add another LiteralControl to the collection at the
' index location of 1.
Dim myLiteralControl As LiteralControl =  _
    new LiteralControl("ChildControl1")
myButton.Controls.Add(myLiteralControl)
myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"))
Response.Write("<b>ChildControl2 is added at index 1</b>")

' Get the Index location of the myLiteralControl LiteralControl
' and write it to the page.
Response.Write("<br /><b>Index of the ChildControl myLiteralControl is </b>" & _
                 myButton.Controls.IndexOf(myLiteralControl))

// Create a LiteralControl and use the Add method to add it
// to a button's ControlCollection, then use the AddAt method
// to add another LiteralControl to the collection at the
// index location of 1.
LiteralControl myLiteralControl = new LiteralControl("ChildControl1");
myButton.Controls.Add(myLiteralControl);
myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"));
Response.Write("<b>ChildControl2 is added at index 1</b>");

// Get the Index location of the myLiteralControl LiteralControl
// and write it to the page.
Response.Write("<br /><b>Index of the ChildControl myLiteralControl is " +
    "</b>" + myButton.Controls.IndexOf(myLiteralControl));

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

ControlCollection クラス
ControlCollection メンバ
System.Web.UI 名前空間
Control.Controls プロパティ