SiteMapNodeCollection.Remove メソッド

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

SiteMapNodeCollection.Remove メソッド

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

指定した SiteMapNode オブジェクトをコレクションから削除します。

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

Visual Basic (宣言)

Public Overridable Sub Remove
 ( _
    value As SiteMapNode _
)

Visual Basic (使用法)

Dim instance As SiteMapNodeCollection
Dim value As SiteMapNode

instance.Remove(value)

C#

public virtual void Remove (
    SiteMapNode value
)

C++

public:
virtual void Remove (
    SiteMapNode^ value
)

J#

public void Remove (
    SiteMapNode value
)

JScript

public function Remove (
    value : SiteMapNode
)

パラメータ

value

SiteMapNodeCollection から削除する SiteMapNode。

例外

例外の種類	条件
ArgumentException	value がコレクション内に存在しません。
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
NotSupportedException	SiteMapNodeCollection は読み取り専用です。 または SiteMapNodeCollection が固定サイズです。

解説

IsReadOnly プロパティをチェックすることにより、SiteMapNodeCollection コレクションが読み取り専用であるかどうかをテストできます。

Remove メソッドは、Object.Equals メソッドを呼び出して、等しいかどうかを判断します。

使用例

Remove メソッドを使用して SiteMapNode オブジェクトを SiteMapNodeCollection コレクションから削除し、Add メソッドを使用して SiteMapNode オブジェクトを SiteMapNodeCollection の末尾に追加する方法を次のコード例に示します。SiteMapNodeCollection が読み取り専用の場合は、NotSupportedException 例外が発生します。

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 名前空間
Add
AddRange