SiteMapNodeCollection.Item プロパティ

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

SiteMapNodeCollection.Item プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Overridable Default
 Property Item ( _
    index As Integer _
) As SiteMapNode

Visual Basic (使用法)

Dim instance As SiteMapNodeCollection
Dim index As Integer
Dim value As SiteMapNode

value = instance(index)

instance(index) = value

C#

public virtual SiteMapNode this [
    int index
] { get; set; }

C++

public:
virtual property SiteMapNode^ default [int]
 {
    SiteMapNode^ get (int index);
    void set (int index,
 SiteMapNode^ value);
}

J#

/** @property */
public SiteMapNode get_Item (int index)

/** @property */
public void set_Item (int
 index, SiteMapNode value)

JScript

JScript では、インデックス付きのプロパティは使用できますが、新規に宣言することはできません。.

パラメータ

index

検索する SiteMapNode のインデックス。

プロパティ値
SiteMapNodeCollection の要素を表す SiteMapNode。

例外

例外の種類	条件
NotSupportedException	SiteMapNodeCollection は読み取り専用です。
ArgumentOutOfRangeException	index が 0 未満です。 または index が Count より大きい値です。
ArgumentNullException	設定側に指定された値が null 参照 (Visual Basic では Nothing) です。

解説

Item インデクサを使用して、SiteMapNodeCollection コレクションの内容を反復処理したり、指定したインデックス位置にある SiteMapNode オブジェクトを置き換えたりできます。

使用例

Item インデクサを使用して、SiteMapNode オブジェクトを SiteMapNodeCollection コレクションから取得する方法を次のコード例に示します。この例では、SiteMapNode オブジェクトが、Remove メソッドを使用して内部配列の第 2 要素の位置から削除され、Add メソッドを使用して配列の末尾に追加されます。SiteMapNode オブジェクトを、配列の末尾に追加するのではなく、特定のインデックス位置に挿入するには、Insert メソッドを使用します。

Visual Basic

' Move a node from one spot in the list to another.
Try
    Response.Write("Original node order: <BR>")
    Dim node As SiteMapNode
    For Each node In nodes
        Response.Write( node.Title & "<BR>")
    Next

    Dim aNode As SiteMapNode = nodes(1)

    Response.Write("Adding " & aNode.Title &
 " to the end of the collection.<BR>")
    nodes.Add(aNode)

    Response.Write("Removing " & aNode.Title &
 " at position 1. <BR>")
    nodes.Remove(nodes(1))

    Response.Write("New node order: <BR>")

    For Each node In nodes
        Response.Write( node.Title & "<BR>")
    Next

Catch nse As NotSupportedException
    Response.Write("NotSupportedException caught.<BR>")
End Try

C#

// Move a node from one spot in the list to another.
try {
    Response.Write("Original node order: <BR>");
    foreach (SiteMapNode node in nodes) {
        Response.Write( node.Title + "<BR>");
    }
    SiteMapNode aNode = nodes[1];

    Response.Write("Adding " + aNode.Title + " to the end of the collection.<BR>");
    nodes.Add(aNode);

    Response.Write("Removing " + aNode.Title + " at position 1. <BR>");
    nodes.Remove(nodes[1]);

    Response.Write("New node order: <BR>");
    foreach (SiteMapNode node in nodes) {
        Response.Write( node.Title + "<BR>");
    }
}
catch (NotSupportedException nse) {
    Response.Write("NotSupportedException caught.<BR>");
}

プラットフォーム

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

参照

関連項目
SiteMapNodeCollection クラス
SiteMapNodeCollection メンバ
System.Web 名前空間
IndexOf
Contains