SiteMap.CurrentNode Свойство

Определение

Возвращает элемент управления SiteMapNode, представляющий запрашиваемую в данный момент страницу.Gets a SiteMapNode control that represents the currently requested page.

public:
 static property System::Web::SiteMapNode ^ CurrentNode { System::Web::SiteMapNode ^ get(); };
public static System.Web.SiteMapNode CurrentNode { get; }
member this.CurrentNode : System.Web.SiteMapNode
Public Shared ReadOnly Property CurrentNode As SiteMapNode

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

Экземпляр SiteMapNode, который представляет запрашиваемую в данный момент страницу, в противном случае — значение null, если требуемый узел отсутствует в карте веб-узла.A SiteMapNode instance that represents the currently requested page; otherwise, null, if no representative node exists in the site map information.

Исключения

Функция карты веб-узла не разрешена.The site map feature is not enabled.

Используемый по умолчанию поставщик, указанный в конфигурации, не существует.The default provider specified in the configuration does not exist.

Данное средство поддерживается только при выполнении с низким уровнем доверия или более высоким уровнем доверия.The feature is supported only when running in Low trust or higher.

Примеры

В следующем примере кода показано, как использовать CurrentNode свойство для SiteMapNode получения объекта, представляющего текущую страницу.The following code example demonstrates how to use the CurrentNode property to retrieve the SiteMapNode object that represents the current page.

<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 получает свойство, запрашивая его от поставщика.The SiteMap class retrieves the CurrentNode property by requesting it from the provider.

Если для страницы в сведениях о карте узла не существует репрезентативного узла или если включена фильтрация безопасности и не удается вернуть узел для текущего пользователя, null возвращается значение.If no representative node exists for the page in the site map information, or if security trimming is enabled and the node cannot be returned for the current user, null is returned.

SiteMapResolve Событие вызывается поставщиком схемы сайта по умолчанию, если одна или несколько подписок существуют.The SiteMapResolve event is raised by the default site map provider if one or more subscriptions exist.

Если вы реализуете собственный SiteMapProvider объект, вы можете создать собственный механизм для поиска и CurrentNodeизвлечения.If you implement your own SiteMapProvider object, you might create your own mechanism to find and retrieve the CurrentNode. Однако если расширить StaticSiteMapProvider класс и использовать схему на основе URL-адресов для определения страниц, можно FindSiteMapNode переопределить метод.However, if you extend the StaticSiteMapProvider class and use a URL-based scheme to identify pages, you can override the FindSiteMapNode method.

Применяется к

Дополнительно