SiteMapNodeCollection.Remove(SiteMapNode) Methode

Definition

Entfernt das angegebene SiteMapNode-Objekt aus der Auflistung.Removes the specified SiteMapNode object from the collection.

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.The SiteMapNode to remove from the SiteMapNodeCollection.

Ausnahmen

Der value ist in der Auflistung nicht vorhanden.value does not exist in the collection.

value ist null.value is null.

SiteMapNodeCollection ist schreibgeschützt.The SiteMapNodeCollection is read-only.

- oder --or- SiteMapNodeCollection hat eine feste Größe.The SiteMapNodeCollection has a fixed size.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Remove -Methode verwendet wird, um ein SiteMapNode -Objekt aus einer Auflistung zu entfernen SiteMapNodeCollection und dann das- SiteMapNode Objekt mithilfe der-Methode an das Ende der anzufügen SiteMapNodeCollection Add .The following code example demonstrates how to use the Remove method to remove a SiteMapNode object from a SiteMapNodeCollection collection, and then append the SiteMapNode object to the end of the SiteMapNodeCollection using the Add method. Wenn die schreibgeschützt SiteMapNodeCollection ist, wird eine- NotSupportedException Ausnahme abgefangen.If the SiteMapNodeCollection is read-only, a NotSupportedException exception is caught.


// 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 Auflistung schreibgeschützt SiteMapNodeCollection ist, indem Sie die-Eigenschaft überprüfen IsReadOnly .You can test whether a SiteMapNodeCollection collection is read-only by checking the IsReadOnly property.

Die- Remove Methode bestimmt Gleichheit durch Aufrufen der- Object.Equals Methode.The Remove method determines equality by calling the Object.Equals method.

Gilt für:

Weitere Informationen