SiteMap.SiteMapResolve Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a CurrentNode propriedade é acedida.
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 Tipo de Evento
Exemplos
O exemplo de código seguinte demonstra como lidar com o evento SiteMapResolve numa página web ASP.NET para modificar os URLs alvo que são exibidos por um controlo de navegação do site, como o controlo SiteMapPath. Neste exemplo, a página atual é uma página de publicação num quadro de avisos ou fórum online. Para tornar a navegação do site mais significativa, os URLs dos nós apresentados pelo controlo de navegação são acrescentados com cadeias de consulta relevantes para o contexto.
Note
A infraestrutura de navegação ASP.NET site protege contra recursividade infinita, o que fornece uma salvaguarda e minimiza o risco de segurança associado ao acesso à propriedade CurrentNode a partir da classe SiteMapResolveEventHandler.
O código seguinte pertence ao ficheiro Global.asax. O gestor de eventos será anexado apenas uma vez para a aplicação. O código reconhece se a página implementa a ISiteMapResolver interface. Se a interface for implementada, a ExpandForumPaths função é chamada.
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
O código seguinte define uma interface separada. (Num projeto de site, pode colocar este código na pasta App_Code.) A ISiteMapResolver interface define o ExpandForumPaths método.
// 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
O código seguinte pertence à página que tem pelo menos três nós de profundidade na estrutura do site-map. A página implementa a ISiteMapResolver interface, que permite chamar o ExpandForumPaths método.
<asp:SiteMapPath
id="SiteMapPath1"
runat="server"
RenderCurrentNodeAsLink="true" />
<asp:SiteMapPath
id="SiteMapPath1"
runat="server"
RenderCurrentNodeAsLink="true" />
Observações
Os subscritores associam um SiteMapResolveEventHandler objeto ao evento estático SiteMapResolve para receber notificações quando a CurrentNode propriedade é acedida. Isto permite ao utilizador implementar lógica personalizada ao criar uma SiteMapNode representação da página em execução sem necessidade de uma implementação personalizada do fornecedor.
Se subscrever o SiteMapResolve evento, também subscreve o SiteMapResolve evento no fornecedor padrão de mapas do site.
