SiteMapNodeCollection.Remove(SiteMapNode) Método

Definição

Remove o objeto SiteMapNode especificado da coleção.

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)

Parâmetros

value
SiteMapNode

O SiteMapNode a ser removido de SiteMapNodeCollection.

Exceções

value não existe na coleção.

value é null.

O SiteMapNodeCollection é somente leitura.

- ou - O SiteMapNodeCollection tem um tamanho fixo.

Exemplos

O exemplo de código a seguir demonstra como usar o Remove método para remover um SiteMapNode objeto de uma SiteMapNodeCollection coleção e, em seguida, acrescentar o SiteMapNode objeto ao final do SiteMapNodeCollection uso do Add método. Se for SiteMapNodeCollection somente leitura, uma NotSupportedException exceção será capturada.


// 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

Comentários

Você pode testar se uma SiteMapNodeCollection coleção é somente leitura verificando a IsReadOnly propriedade.

O Remove método determina a igualdade chamando o Object.Equals método.

Aplica-se a

Confira também