SiteMapProvider.CurrentNode プロパティ

定義

現在要求されているページを表す SiteMapNode オブジェクトを取得します。Gets the SiteMapNode object that represents the currently requested page.

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

プロパティ値

現在要求されているページを表す SiteMapNodeSiteMapNode が見つからなかった場合、または見つかったが現在のユーザーに返すことができない場合は nullA SiteMapNode that represents the currently requested page; otherwise, null, if the SiteMapNode is not found or cannot be returned for the current user.

次のコード例は、抽象CurrentNode SiteMapProviderクラスを実装するクラスにプロパティを実装する方法を示しています。The following code example demonstrates how to implement the CurrentNode property in a class that implements the abstract SiteMapProvider class.

このコード例は、 SiteMapProviderクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the SiteMapProvider class.

// Implement the CurrentNode property.
public override SiteMapNode CurrentNode
{
  get
  {
    string currentUrl = FindCurrentUrl();
    // Find the SiteMapNode that represents the current page.
    SiteMapNode currentNode = FindSiteMapNode(currentUrl);
    return currentNode;
  }
}

// Implement the RootNode property.
public override SiteMapNode RootNode
{
  get
  {
    return rootNode;
  }
}
' Implement the CurrentNode property.
Public Overrides ReadOnly Property CurrentNode() As SiteMapNode
  Get
    Dim currentUrl As String = FindCurrentUrl()
    ' Find the SiteMapNode that represents the current page.
    Dim aCurrentNode As SiteMapNode = FindSiteMapNode(currentUrl)
    Return aCurrentNode
  End Get
End Property

' Implement the RootNode property.
Public Overrides ReadOnly Property RootNode() As SiteMapNode
  Get
    Return aRootNode
  End Get
End Property

注釈

イベントは、 SiteMapNodeオブジェクトを取得しようとする前に発生し、イベントサブスクライバーがSiteMapNodeクラスのインスタンスを返すことができるようにします。 SiteMapResolveThe SiteMapResolve event is raised before attempting to retrieve a SiteMapNode object, to enable event subscribers to return an instance of the SiteMapNode class. イベントサブスクライバーが存在しない場合、 SiteMapProviderクラスは現在FindSiteMapNodeの HTTP コンテキストを使用してメソッドをSiteMapNode呼び出し、現在要求されているページを表すを取得します。If there are no event subscribers, the SiteMapProvider class calls the FindSiteMapNode method using the current HTTP context to retrieve a SiteMapNode that represents the currently requested page.

現在要求されているページがに対応SiteMapNodenullていない場合は、が返されます。If the currently requested page does not correspond with a SiteMapNode, null is returned. セキュリティトリミングが有効で、ユーザーがへのSiteMapNodeアクセスを許可されていない場合は、 nullが返されます。If security trimming is enabled and the user is not permitted to access the SiteMapNode, null is returned.

適用対象

こちらもご覧ください