SiteMapProvider.GetChildNodes(SiteMapNode) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Cuando se reemplaza en una clase derivada, recupera los nodos secundarios de un SiteMapNode concreto.

public:
 abstract System::Web::SiteMapNodeCollection ^ GetChildNodes(System::Web::SiteMapNode ^ node);

public abstract System.Web.SiteMapNodeCollection GetChildNodes (System.Web.SiteMapNode node);

abstract member GetChildNodes : System.Web.SiteMapNode -> System.Web.SiteMapNodeCollection

Public MustOverride Function GetChildNodes (node As SiteMapNode) As SiteMapNodeCollection

Parámetros

node

SiteMapNode

SiteMapNode cuyos nodos secundarios se van a recuperar.

Devoluciones

SiteMapNodeCollection

Es un SiteMapNodeCollection de sólo lectura que contiene los nodos secundarios inmediatos del SiteMapNodeespecificado; de lo contrario, es null o una colección vacía si no existe ningún nodo secundario.

Ejemplos

En el ejemplo de código siguiente se muestra cómo implementar el GetChildNodes método en una clase que implementa la clase abstracta SiteMapProvider . SimpleTextSiteMapProvider almacena las relaciones jerárquicas primarias o secundarias en un Hashtable objeto y en todos los SiteMapNode objetos de otro. El GetChildNodes método realiza una búsqueda inversa mediante ambos ArrayList objetos.

Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase SiteMapProvider.

// Implement the GetChildNodes method.
public override SiteMapNodeCollection GetChildNodes(SiteMapNode node)
{
  SiteMapNodeCollection children = new SiteMapNodeCollection();
  // Iterate through the ArrayList and find all nodes that have the specified node as a parent.
  lock (this)
  {
    for (int i = 0; i < childParentRelationship.Count; i++)
    {

      string nodeUrl = ((DictionaryEntry)childParentRelationship[i]).Key as string;

      SiteMapNode parent = GetNode(childParentRelationship, nodeUrl);

      if (parent != null && node.Url == parent.Url)
      {
        // The SiteMapNode with the Url that corresponds to nodeUrl
        // is a child of the specified node. Get the SiteMapNode for
        // the nodeUrl.
        SiteMapNode child = FindSiteMapNode(nodeUrl);
        if (child != null)
        {
          children.Add(child as SiteMapNode);
        }
        else
        {
          throw new Exception("ArrayLists not in sync.");
        }
      }
    }
  }
  return children;
}
protected override SiteMapNode GetRootNodeCore()
{
  return RootNode;
}
// Implement the GetParentNode method.
public override SiteMapNode GetParentNode(SiteMapNode node)
{
  // Check the childParentRelationship table and find the parent of the current node.
  // If there is no parent, the current node is the RootNode.
  SiteMapNode parent = null;
  lock (this)
  {
    // Get the Value of the node in childParentRelationship
    parent = GetNode(childParentRelationship, node.Url);
  }
  return parent;
}

' Implement the GetChildNodes method.
Public Overrides Function GetChildNodes(ByVal node As SiteMapNode) As SiteMapNodeCollection
  Dim children As New SiteMapNodeCollection()
  ' Iterate through the ArrayList and find all nodes that have the specified node as a parent.
  SyncLock Me
    Dim i As Integer
    For i = 0 To childParentRelationship.Count - 1

      Dim de As DictionaryEntry = CType(childParentRelationship(i), DictionaryEntry)
      Dim nodeUrl As String = CType(de.Key, String)

      Dim parent As SiteMapNode = GetNode(childParentRelationship, nodeUrl)

      If Not (parent Is Nothing) AndAlso node.Url = parent.Url Then
        ' The SiteMapNode with the Url that corresponds to nodeUrl
        ' is a child of the specified node. Get the SiteMapNode for
        ' the nodeUrl.
        Dim child As SiteMapNode = FindSiteMapNode(nodeUrl)
        If Not (child Is Nothing) Then
          children.Add(CType(child, SiteMapNode))
        Else
          Throw New Exception("ArrayLists not in sync.")
        End If
      End If
    Next i
  End SyncLock
  Return children
End Function 'GetChildNodes

Protected Overrides Function GetRootNodeCore() As SiteMapNode
  Return RootNode
End Function ' GetRootNodeCore()

' Implement the GetParentNode method.
Public Overrides Function GetParentNode(ByVal node As SiteMapNode) As SiteMapNode
  ' Check the childParentRelationship table and find the parent of the current node.
  ' If there is no parent, the current node is the RootNode.
  Dim parent As SiteMapNode = Nothing
  SyncLock Me
    ' Get the Value of the node in childParentRelationship
    parent = GetNode(childParentRelationship, node.Url)
  End SyncLock
  Return parent
End Function 'GetParentNode

Comentarios

Las clases que derivan de la SiteMapProvider clase deben implementar el método abstracto GetChildNodes .

Notas a los implementadores

Al invalidar el GetChildNodes(SiteMapNode) método en una clase derivada, asegúrese de realizar el recorte de seguridad en los nodos secundarios y asegurarse de que la colección devuelta es de solo lectura. La colección contiene solo los elementos secundarios inmediatos del especificado node.

Consulte también

• GetParentNode(SiteMapNode)