SiteMapNode Sınıf

Tanım

public ref class SiteMapNode : ICloneable, System::Web::UI::IHierarchyData, System::Web::UI::INavigateUIData

public class SiteMapNode : ICloneable, System.Web.UI.IHierarchyData, System.Web.UI.INavigateUIData

type SiteMapNode = class
    interface ICloneable
    interface IHierarchyData
    interface INavigateUIData

Public Class SiteMapNode
Implements ICloneable, IHierarchyData, INavigateUIData

Devralma

Object

SiteMapNode

Uygulamalar

ICloneable IHierarchyData INavigateUIData

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneğinde yeni bir site haritası düğüm koleksiyonunun nasıl oluşturulacağı ve bu koleksiyona nasıl öğe ekleneceği gösterilmektedir. İkinci kod örneği, bir metin dosyasından site eşleme verilerinin nasıl yüklenip yüklenemediğni gösterir.

Aşağıdaki kod örneği, oluşturucuyu SiteMapNodeCollection kullanarak yeni SiteMapNodeCollection bir koleksiyon oluşturmayı ve ardından yöntemiyle Add öğe eklemeyi gösterir.

// The LoadSiteMapData() method loads site navigation
// data from persistent storage into a DataTable.
DataTable siteMap = LoadSiteMapData();

// Create a SiteMapNodeCollection.
SiteMapNodeCollection nodes = new SiteMapNodeCollection();

// Create a SiteMapNode and add it to the collection.
SiteMapNode tempNode;
DataRow row;
int index = 0;

while (index < siteMap.Rows.Count)
{

    row = siteMap.Rows[index];

    // Create a node based on the data in the DataRow.
    tempNode = new SiteMapNode(SiteMap.Provider,
                                row["Key"].ToString(),
                                row["Url"].ToString());

    // Add the node to the collection.
    nodes.Add(tempNode);
    ++index;
}

' The LoadSiteMapData() Function loads site navigation
' data from persistent storage into a DataTable.

Dim siteMapData As DataTable
siteMapData = LoadSiteMapData()

' Create a SiteMapNodeCollection.
Dim nodes As New SiteMapNodeCollection()

' Create a SiteMapNode and add it to the collection.
Dim tempNode As SiteMapNode
Dim row As DataRow
Dim index As Integer
index = 0

While (index < siteMapData.Rows.Count)

    row = siteMapData.Rows(index)

    ' Create a node based on the data in the DataRow.
    tempNode = New SiteMapNode(SiteMap.Provider, row("Key").ToString(), row("Url").ToString())

    ' Add the node to the collection.
    nodes.Add(tempNode)
    index = index + 1
End While

Aşağıdaki kod örneği, virgülle ayrılmış dizelerde site haritası verilerini içeren bir metin dosyasını nasıl SimpleTextSiteMapProvider ayrıştırdığını gösterir. Dosyasından okunan her satır için sınıfının iç izleme koleksiyonlarına yeni SiteMapNode bir nesne eklenir.

Bu kod örneği, sınıfı için SiteMapProvider sağlanan daha büyük bir örneğin parçasıdır.

protected virtual void LoadSiteMapFromStore()
{
  string pathToOpen;

  lock (this)
  {
    // If a root node exists, LoadSiteMapFromStore has already
    // been called, and the method can return.
    if (rootNode != null)
    {
      return;
    }
    else
    {
      pathToOpen = HttpContext.Current.Server.MapPath("~" + "\\" + sourceFilename);

      if (File.Exists(pathToOpen))
      {
        // Open the file to read from.
        using (StreamReader sr = File.OpenText(pathToOpen))
        {

          // Clear the state of the collections and rootNode
          rootNode = null;
          siteMapNodes.Clear();
          childParentRelationship.Clear();

          // Parse the file and build the site map
          string s = "";
          string[] nodeValues = null;
          SiteMapNode temp = null;

          while ((s = sr.ReadLine()) != null)
          {

            // Build the various SiteMapNode objects and add
            // them to the ArrayList collections. The format used
            // is: URL,TITLE,DESCRIPTION,PARENTURL

            nodeValues = s.Split(',');

            temp = new SiteMapNode(this,
                HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                nodeValues[1],
                nodeValues[2]);

            // Is this a root node yet?
            if (null == rootNode &&
                string.IsNullOrEmpty(nodeValues[3]))
            {
              rootNode = temp;
            }

          // If not the root node, add the node to the various collections.
            else
            {
              siteMapNodes.Add(new DictionaryEntry(temp.Url, temp));
              // The parent node has already been added to the collection.
              SiteMapNode parentNode =
                       FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[3]);
              if (parentNode != null)
              {
                childParentRelationship.Add(new DictionaryEntry(temp.Url, parentNode));
              }
              else
              {
                throw new Exception("Parent node not found for current node.");
              }
            }
          }
        }
      }
      else
      {
        throw new Exception("File not found");
      }
    }
  }
  return;
}

  Protected Overridable Sub LoadSiteMapFromStore()
    Dim pathToOpen As String
    SyncLock Me
      ' If a root node exists, LoadSiteMapFromStore has already
      ' been called, and the method can return.
      If Not (aRootNode Is Nothing) Then
        Return
      Else
        pathToOpen = HttpContext.Current.Server.MapPath("~" & "\\" & sourceFilename)
        If File.Exists(pathToOpen) Then
          ' Open the file to read from.
          Dim sr As StreamReader = File.OpenText(pathToOpen)
          Try

            ' Clear the state of the collections and aRootNode
            aRootNode = Nothing
            siteMapNodes.Clear()
            childParentRelationship.Clear()

            ' Parse the file and build the site map
            Dim s As String = ""
            Dim nodeValues As String() = Nothing
            Dim temp As SiteMapNode = Nothing

            Do
              s = sr.ReadLine()

              If Not s Is Nothing Then
                ' Build the various SiteMapNode objects and add
                ' them to the ArrayList collections. The format used
                ' is: URL,TITLE,DESCRIPTION,PARENTURL
                nodeValues = s.Split(","c)

                temp = New SiteMapNode(Me, _
                    HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(0), _
                    HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(0), _
                    nodeValues(1), _
                    nodeValues(2))

                ' Is this a root node yet?
                If aRootNode Is Nothing AndAlso _
                  (nodeValues(3) Is Nothing OrElse _
                   nodeValues(3) = String.Empty) Then
                  aRootNode = temp

                  ' If not the root node, add the node to the various collections.
                Else

                  siteMapNodes.Add(New DictionaryEntry(temp.Url, temp))

                  ' The parent node has already been added to the collection.
                  Dim parentNode As SiteMapNode = _
                      FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath & "/" & nodeValues(3))

                  If Not (parentNode Is Nothing) Then
                    childParentRelationship.Add(New DictionaryEntry(temp.Url, parentNode))
                  Else
                    Throw New Exception("Parent node not found for current node.")
                  End If
                End If
              End If
            Loop Until s Is Nothing
          Finally
            sr.Close()
          End Try
        Else
          Throw New Exception("File not found")
        End If
      End If
    End SyncLock
    Return
  End Sub
End Class

Açıklamalar

Nesne SiteMapNode , site haritası yapısındaki bir Web sitesi sayfasını temsil eder. SiteMapNode nesneleri, kalıcı depolama alanından belleğe site eşlemesi verilerini yüklemek için bir veya daha fazla site haritası sağlayıcısı kullanılarak çalışma zamanında statik SiteMap sınıf tarafından yüklenir. SiteMapNodenesneleri, denetim gibi SiteMapPath Web sunucusu denetimleri tarafından kullanılmak üzere sınıfı tarafından sarmalanmıştırSiteMapNodeItem.

sınıfı, SiteMapNode , ve Description özellikleri gibi bir sayfayı açıklayan özellikler de dahil olmak üzere Bir Web sitesindeki tek bir sayfayı UrlTitletanımlamak için kullanılan çeşitli özellikler içerir. Url özelliği, ASP.NET için varsayılan site haritası sağlayıcısı olan sınıfı tarafından XmlSiteMapProvider kullanılırken, sağlayıcının düğümleri izlemek için kullandığı iç koleksiyonlarda arama anahtarı olarak kullanılırken, sınıf, SiteMapNode düğümleri izlemek için site haritası sağlayıcıları tarafından kullanılabilecek temel Key bir özelliği destekler. Ayrıca özelliği, Url gezinti denetimleri tarafından bir gezinti yapısı içindeki sayfalara köprüler işlemek için kullanılır. Title özelliği, için SiteMapNodekolay bir addır, genellikle Web Formunun HTML başlığıyla aynıdır ve gezinti denetimleri tarafından basit etiketleri işlemek için kullanılır. Son olarak, NameValueCollection nesneleri kullanan SiteMapNode ancak temel SiteMapNode sınıfta bulunmayan ek Attributes özellikler gerektiren site eşleme sağlayıcıları için ek öznitelik koleksiyonu sağlanır.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• SiteMap
• SiteMapProvider
• XmlSiteMapProvider
• ASP.NET Site Gezintisi'ne Genel Bakış
• Site Haritalarını ASP.NET