ListItemCollection.GetEnumerator メソッド

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

ListItemCollection.GetEnumerator メソッド

ListItemCollection のすべての ListItem オブジェクトを格納している System.Collections.IEnumerator 実装オブジェクトを返します。

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

Visual Basic (宣言)

Public Function GetEnumerator As
 IEnumerator

Visual Basic (使用法)

Dim instance As ListItemCollection
Dim returnValue As IEnumerator

returnValue = instance.GetEnumerator

C#

public IEnumerator GetEnumerator ()

C++

public:
virtual IEnumerator^ GetEnumerator () sealed

J#

public final IEnumerator GetEnumerator ()

JScript

public final function GetEnumerator () : IEnumerator

戻り値
ListItemCollection のすべての ListItem オブジェクトを格納している System.Collections.IEnumerator 実装オブジェクト。

解説

このメソッドを使用して、ListItemCollection の各 ListItem オブジェクトを取得するために反復処理できる System.Collections.IEnumerator を作成します。

IEnumerator.Current プロパティを使用して、コレクション内で現在ポインタが指している項目を取得します。

IEnumerator.MoveNext メソッドを使用して、コレクション内の次の項目に移動します。

IEnumerator.Reset メソッドを使用して、列挙子を初期の位置に戻します。

メモ
System.Collections.IEnumerator オブジェクトを作成したり、IEnumerator.Reset メソッドを使用したりして列挙子をコレクションの最初の項目に移動した後は、IEnumerator.MoveNext メソッドを呼び出す必要があります。このメソッドを呼び出さないと、IEnumerator.Current プロパティで表される項目は未定義になります。

使用例

Visual Basic

Sub AllItems_Click(sender As Object,
 e As EventArgs)
    Dim dataListEnumerator As IEnumerator
    Dim currentItem As DataListItem 
    lblAllItems.Text = ""
    ' Get an enumerator to traverse the DataListItemCollection.
    dataListEnumerator = myDataList.Items.GetEnumerator()
    while(dataListEnumerator.MoveNext())
        currentItem = CType(dataListEnumerator.Current,DataListItem)
        ' Display the current DataListItem onto the label.
        lblAllItems.Text = lblAllItems.Text & CType((currentItem.Controls(1)),Label).Text
 & "  "
    End While
End Sub

C#

void allItems_Click(Object sender,EventArgs e)
{
    IEnumerator dataListEnumerator;
    DataListItem currentItem;
    lblAllItems.Text = "";
    // Get an enumerator to traverse the DataListItemCollection.
    dataListEnumerator = myDataList.Items.GetEnumerator();
    while(dataListEnumerator.MoveNext())
    {
        currentItem = (DataListItem)dataListEnumerator.Current;
        // Display the current DataListItem onto the label.
        lblAllItems.Text += ((Label)(currentItem.Controls[1])).Text + " ";
    }
}

J#

void AllItems_Click(Object sender, EventArgs e)
{
    IEnumerator dataListEnumerator;
    DataListItem currentItem;
    lblAllItems.set_Text("");
    
    // Get an enumerator to traverse the DataListItemCollection.
    dataListEnumerator = myDataList.get_Items().GetEnumerator();
    while(dataListEnumerator.MoveNext()) {
        currentItem =((DataListItem)(dataListEnumerator.get_Current()));
        // Display the current DataListItem onto the label.
        lblAllItems.set_Text(lblAllItems.get_Text() 
            +((Label)(currentItem.get_Controls() .get_Item( 1))).get_Text() 
            + " ");
    }
} //AllItems_Click

プラットフォーム

Windows 98, Windows 2000 SP4, 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、1.1、1.0

参照

関連項目
ListItemCollection クラス
ListItemCollection メンバ
System.Web.UI.WebControls 名前空間
IEnumerable
IEnumerator.Reset
IEnumerator.MoveNext
IEnumerator.Current