SiteMap.SiteMapResolve Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer de CurrentNode eigenschap wordt geopend.
public:
static event System::Web::SiteMapResolveEventHandler ^ SiteMapResolve;public static event System.Web.SiteMapResolveEventHandler SiteMapResolve;member this.SiteMapResolve : System.Web.SiteMapResolveEventHandler Public Shared Custom Event SiteMapResolve As SiteMapResolveEventHandler Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de gebeurtenis SiteMapResolve op een ASP.NET webpagina kunt afhandelen om de doel-URL's te wijzigen die worden weergegeven door een sitenavigatiebeheer, zoals het besturingselement SiteMapPath. In dit voorbeeld is de huidige pagina een postpagina in een online bulletin board of forum. Om zinvollere sitenavigatie weer te geven, worden de URL's van de knooppunten die door het navigatiebesturingselement worden weergegeven, toegevoegd met context relevante queryreeksen.
Note
De ASP.NET sitenavigatie-infrastructuur beschermt tegen oneindige recursie, die een beveiliging biedt en het beveiligingsrisico minimaliseert dat is gekoppeld aan toegang tot de eigenschap CurrentNode vanuit de klasse SiteMapResolveEventHandler.
De volgende code behoort tot het bestand Global.asax. De gebeurtenis-handler wordt slechts eenmaal gekoppeld voor de toepassing. De code herkent of de pagina de ISiteMapResolver interface implementeert. Als de interface is geïmplementeerd, wordt de ExpandForumPaths functie aangeroepen.
private void Page_Load(object sender, EventArgs e)
{
// The ExpandForumPaths method is called to handle
// the SiteMapResolve event.
SiteMap.SiteMapResolve +=
new SiteMapResolveEventHandler(this.ExpandForumPaths);
}
private SiteMapNode ExpandForumPaths(Object sender, SiteMapResolveEventArgs e)
{
// The current node represents a Post page in a bulletin board forum.
// Clone the current node and all of its relevant parents. This
// returns a site map node that a developer can then
// walk, modifying each node.Url property in turn.
// Since the cloned nodes are separate from the underlying
// site navigation structure, the fixups that are made do not
// effect the overall site navigation structure.
SiteMapNode currentNode = SiteMap.CurrentNode.Clone(true);
SiteMapNode tempNode = currentNode;
// Obtain the recent IDs.
int forumGroupID = GetMostRecentForumGroupID();
int forumID = GetMostRecentForumID(forumGroupID);
int postID = GetMostRecentPostID(forumID);
// The current node, and its parents, can be modified to include
// dynamic querystring information relevant to the currently
// executing request.
if (0 != postID)
{
tempNode.Url = tempNode.Url + "?PostID=" + postID.ToString();
}
if ((null != (tempNode = tempNode.ParentNode)) &&
(0 != forumID))
{
tempNode.Url = tempNode.Url + "?ForumID=" + forumID.ToString();
}
if ((null != (tempNode = tempNode.ParentNode)) &&
(0 != forumGroupID))
{
tempNode.Url = tempNode.Url + "?ForumGroupID=" + forumGroupID.ToString();
}
return currentNode;
}
Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' The ExpandForumPaths method is called to handle
' the SiteMapResolve event.
AddHandler SiteMap.SiteMapResolve, AddressOf Me.ExpandForumPaths
End Sub
Private Function ExpandForumPaths(ByVal sender As Object, ByVal e As SiteMapResolveEventArgs) As SiteMapNode
' The current node represents a Post page in a bulletin board forum.
' Clone the current node and all of its relevant parents. This
' returns a site map node that a developer can then
' walk, modifying each node.Url property in turn.
' Since the cloned nodes are separate from the underlying
' site navigation structure, the fixups that are made do not
' effect the overall site navigation structure.
Dim currentNode As SiteMapNode = SiteMap.CurrentNode.Clone(True)
Dim tempNode As SiteMapNode = currentNode
' Obtain the recent IDs.
Dim forumGroupID As Integer = GetMostRecentForumGroupID()
Dim forumID As Integer = GetMostRecentForumID(forumGroupID)
Dim postID As Integer = GetMostRecentPostID(forumID)
' The current node, and its parents, can be modified to include
' dynamic querystring information relevant to the currently
' executing request.
If Not (0 = postID) Then
tempNode.Url = tempNode.Url & "?PostID=" & postID.ToString()
End If
tempNode = tempNode.ParentNode
If Not (0 = forumID) And Not (tempNode Is Nothing) Then
tempNode.Url = tempNode.Url & "?ForumID=" & forumID.ToString()
End If
tempNode = tempNode.ParentNode
If Not (0 = ForumGroupID) And Not (tempNode Is Nothing) Then
tempNode.Url = tempNode.Url & "?ForumGroupID=" & forumGroupID.ToString()
End If
Return currentNode
End Function
De volgende code definieert een afzonderlijke interface. (In een websiteproject kunt u deze code in de map App_Code plaatsen.) De ISiteMapResolver interface definieert de ExpandForumPaths methode.
// These methods are just placeholders for the example.
// One option is to use the HttpContext or e.Context object
// to obtain the ID.
private int GetMostRecentForumGroupID()
{
return 24;
}
private int GetMostRecentForumID(int forumGroupId)
{
return 128;
}
private int GetMostRecentPostID(int forumId)
{
return 317424;
}
' These methods are just placeholders for the example.
' One option is to use the HttpContext or e.Context object
' to obtain the ID.
Private Function GetMostRecentForumGroupID() As Integer
Return 24
End Function
Private Function GetMostRecentForumID(ByVal forumGroupId As Integer) As Integer
Return 128
End Function
Private Function GetMostRecentPostID(ByVal forumId As Integer) As Integer
Return 317424
End Function
De volgende code behoort tot de pagina met ten minste drie knooppunten diep in de siteoverzichtstructuur. De pagina implementeert de ISiteMapResolver interface, waarmee de ExpandForumPaths methode kan worden aangeroepen.
<asp:SiteMapPath
id="SiteMapPath1"
runat="server"
RenderCurrentNodeAsLink="true" />
<asp:SiteMapPath
id="SiteMapPath1"
runat="server"
RenderCurrentNodeAsLink="true" />
Opmerkingen
Abonnees voegen een SiteMapResolveEventHandler object toe aan de statische SiteMapResolve gebeurtenis om een melding te ontvangen wanneer de CurrentNode eigenschap wordt geopend. Hierdoor kan de gebruiker aangepaste logica implementeren bij het maken van een SiteMapNode weergave van de pagina die momenteel wordt uitgevoerd zonder dat hiervoor een aangepaste provider hoeft te worden geïmplementeerd.
Als u zich abonneert op de SiteMapResolve gebeurtenis, abonneert u zich ook op de SiteMapResolve gebeurtenis op de standaardsiteoverzichtprovider.
