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