SiteMapProvider.CurrentNode SiteMapProvider.CurrentNode SiteMapProvider.CurrentNode SiteMapProvider.CurrentNode Property

Definition

Ruft das SiteMapNode-Objekt ab, das die gerade angeforderte Seite darstellt.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

Eigenschaftswert

Ein SiteMapNode, der die gerade angeforderte Seite darstellt. Andernfalls null, wenn der SiteMapNode nicht gefunden wird oder für den aktuellen Benutzer nicht zurückgegeben werden kann.A SiteMapNode that represents the currently requested page; otherwise, null, if the SiteMapNode is not found or cannot be returned for the current user.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CurrentNode -Eigenschaft in einer Klasse implementiert wird, SiteMapProvider die die abstrakte-Klasse implementiert.The following code example demonstrates how to implement the CurrentNode property in a class that implements the abstract SiteMapProvider class.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SiteMapProvider -Klasse bereitgestellt wird.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

Hinweise

Das SiteMapResolve -Ereignis wird ausgelöst, bevor versucht wird SiteMapNode , ein-Objekt abzurufen, damit Ereignis Abonnenten eine Instanz der SiteMapNode -Klasse zurückgeben können.The SiteMapResolve event is raised before attempting to retrieve a SiteMapNode object, to enable event subscribers to return an instance of the SiteMapNode class. Wenn keine Ereignis Abonnenten vorhanden sind, ruft SiteMapProvider die-Klasse FindSiteMapNode die-Methode mit dem aktuellen HTTP-Kontext SiteMapNode auf, um einen abzurufen, der die aktuell angeforderte Seite darstellt.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.

Wenn die aktuell angeforderte Seite nicht mit SiteMapNodeübereinstimmt, null wird zurückgegeben.If the currently requested page does not correspond with a SiteMapNode, null is returned. Wenn die Sicherheits Kürzung aktiviert ist und der Benutzer nicht auf das SiteMapNodezugreifen darf, null wird zurückgegeben.If security trimming is enabled and the user is not permitted to access the SiteMapNode, null is returned.

Gilt für:

Siehe auch