Share via

SiteMapNodeCollection.Remove(SiteMapNode) Methode

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Entfernt das angegebene SiteMapNode-Objekt aus der Auflistung.

public:
 virtual void Remove(System::Web::SiteMapNode ^ value);
public virtual void Remove (System.Web.SiteMapNode value);
abstract member Remove : System.Web.SiteMapNode -> unit
override this.Remove : System.Web.SiteMapNode -> unit
Public Overridable Sub Remove (value As SiteMapNode)

Parameter

value
SiteMapNode

Der SiteMapNode, der aus der SiteMapNodeCollection entfernt werden soll.

Ausnahmen

ArgumentException

Der value ist in der Auflistung nicht vorhanden.

ArgumentNullException

value ist null.

NotSupportedException

SiteMapNodeCollection ist schreibgeschützt.

- oder - SiteMapNodeCollection hat eine feste Größe.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der Remove Methode ein SiteMapNode Objekt aus einer SiteMapNodeCollection Auflistung entfernen und dann das SiteMapNode Objekt an das Ende der SiteMapNodeCollection Methode Add anfügen. Wenn die SiteMapNodeCollection Schreibgeschützt ist, wird eine NotSupportedException Ausnahme abgefangen.


// 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>");
}


' 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

Hinweise

Sie können testen, ob eine SiteMapNodeCollection Auflistung schreibgeschützt ist, indem Sie die IsReadOnly Eigenschaft überprüfen.

Die Remove Methode bestimmt die Gleichheit durch Aufrufen der Object.Equals Methode.

Gilt für

Siehe auch