SiteMapProvider.GetChildNodes(SiteMapNode) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Po przesłonięciu w klasie pochodnej pobiera węzły podrzędne określonego SiteMapNodeelementu .

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

Parametry

node

SiteMapNode

Element SiteMapNode , dla którego mają być pobierane wszystkie węzły podrzędne.

Zwraca

SiteMapNodeCollection

Tylko SiteMapNodeCollection do odczytu, który zawiera natychmiastowe węzły podrzędne określonego SiteMapNode; w przeciwnym razie null lub pustą kolekcję, jeśli nie istnieją żadne węzły podrzędne.

Przykłady

W poniższym przykładzie kodu pokazano, jak zaimplementować metodę GetChildNodes w klasie, która implementuje klasę abstrakcyjną SiteMapProvider . Obiekt SimpleTextSiteMapProvider przechowuje hierarchiczne relacje nadrzędne/podrzędne w jednym Hashtable obiekcie i we wszystkich SiteMapNode obiektach w innym. Metoda GetChildNodes wykonuje wyszukiwanie odwrotne przy użyciu obu ArrayList obiektów.

Ten przykład kodu jest częścią większego przykładu udostępnionego SiteMapProvider dla klasy .

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

Uwagi

Klasy pochodzące z SiteMapProvider klasy muszą implementować metodę abstrakcyjną GetChildNodes .

Uwagi dotyczące implementowania

Podczas zastępowania GetChildNodes(SiteMapNode) metody w klasie pochodnej należy wykonać przycinanie zabezpieczeń w węzłach podrzędnych i upewnić się, że zwracana kolekcja jest tylko do odczytu. Kolekcja zawiera tylko bezpośrednie elementy podrzędne określonego nodeelementu .

Zobacz też

• GetParentNode(SiteMapNode)