SiteMap.CurrentNode Свойство

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Возвращает элемент управления SiteMapNode, представляющий запрашиваемую в данный момент страницу.

public:
 static property System::Web::SiteMapNode ^ CurrentNode { System::Web::SiteMapNode ^ get(); };

public static System.Web.SiteMapNode CurrentNode { get; }

static member CurrentNode : System.Web.SiteMapNode

Public Shared ReadOnly Property CurrentNode As SiteMapNode

Значение свойства

SiteMapNode

Экземпляр SiteMapNode, который представляет запрашиваемую в данный момент страницу, в противном случае — значение null, если требуемый узел отсутствует в карте веб-узла.

Исключения

InvalidOperationException

Функция карты веб-узла не разрешена.

ConfigurationErrorsException

Используемый по умолчанию поставщик, указанный в конфигурации, не существует.

HttpException

Данное средство поддерживается только при выполнении с низким уровнем доверия или более высоким уровнем доверия.

Примеры

В следующем примере кода показано, как использовать CurrentNode свойство для получения SiteMapNode объекта, представляющего текущую страницу.

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Examine the CurrentNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.CurrentNode.Title + "<br />");
    Response.Write("<font COLOR='red'>" + SiteMap.CurrentNode.Url + "</font><br />");

    // What nodes are children of the CurrentNode?
    if (SiteMap.CurrentNode.HasChildNodes) {
        IEnumerator childNodesEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator();
        while (childNodesEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(childNodesEnumerator.Current.ToString() + "<br />");
        }
    }
    Response.Write("<hr />");

    // Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title + "<br />");
    Response.Write(SiteMap.RootNode.Url + "<br />");

    // What nodes are children of the RootNode?
    if (SiteMap.RootNode.HasChildNodes) {
        IEnumerator rootNodesChildrenEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator();
        while (rootNodesChildrenEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(rootNodesChildrenEnumerator.Current.ToString() + "<br />");
        }
    }
}
</script>

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Examine the CurrentNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.CurrentNode.Title & "<br />")
    Response.Write("<font COLOR='red'>" & SiteMap.CurrentNode.Url & "</font><br />")

    ' What nodes are children of the CurrentNode?
    If (SiteMap.CurrentNode.HasChildNodes) Then
        Dim ChildNodesEnumerator As IEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator()
        While (ChildNodesEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(ChildNodesEnumerator.Current.ToString() & "<br />")
        End While
    End If
    Response.Write("<hr />")

    ' Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title & "<br />")
    Response.Write(SiteMap.RootNode.Url & "<br />")

    ' What nodes are children of the RootNode?
    If (SiteMap.RootNode.HasChildNodes) Then
        Dim RootNodesChildrenEnumerator As IEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator()
        While (RootNodesChildrenEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(RootNodesChildrenEnumerator.Current.ToString() & "<br />")
        End While
    End If

End Sub ' Page_Load
</script>

Комментарии

Класс SiteMap получает свойство, CurrentNode запрашивая его у поставщика.

Если для страницы в сведениях карты сайта не существует репрезентативного узла или если включена обрезка безопасности и узел не может быть возвращен для текущего пользователя, null возвращается.

Событие SiteMapResolve вызывается поставщиком карты сайта по умолчанию, если существует одна или несколько подписок.

При реализации собственного SiteMapProvider объекта можно создать собственный механизм для поиска и извлечения CurrentNode. Однако если расширить StaticSiteMapProvider класс и использовать схему на основе URL-адресов для идентификации страниц, можно переопределить FindSiteMapNode метод .

См. также раздел

• CurrentNode
• SiteMapResolve