SiteMapResolveEventArgs Classe

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Fornece dados para um evento gerado chamando a propriedade CurrentNode da classe SiteMapProvider.

public ref class SiteMapResolveEventArgs : EventArgs

public class SiteMapResolveEventArgs : EventArgs

type SiteMapResolveEventArgs = class
    inherit EventArgs

Public Class SiteMapResolveEventArgs
Inherits EventArgs

Herança

Object

EventArgs

SiteMapResolveEventArgs

Exemplos

O exemplo de código a seguir demonstra como manipular o SiteMapResolve evento em uma página da Web ASP.NET para modificar as URLs de destino exibidas por um controle de navegação do site, como o SiteMapPath controle . Neste exemplo, a página atual é uma página de postagem em um quadro de avisos online ou fórum. Para renderizar uma navegação de site mais significativa, as URLs dos nós exibidos pelo controle de navegação são acrescentadas com cadeias de caracteres de consulta relevantes para o contexto.

Nota É seguro acessar a CurrentNode propriedade de dentro da SiteMapResolveEventHandler classe . A infraestrutura de navegação do site ASP.NET protege contra a recursão infinita, nesse caso.

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

Comentários

A SiteMapResolveEventArgs classe é usada no ResolveSiteMapNode método para permitir que os assinantes do SiteMapResolve evento retornem uma instância da SiteMapNode classe . Ao adicionar um delegado do manipulador de eventos para manipular o SiteMapResolve evento, você pode criar uma SiteMapNode representação de uma página sem implementar um provedor de mapa de site personalizado.

Construtores

SiteMapResolveEventArgs(HttpContext, SiteMapProvider)

Inicializa uma nova instância da classe SiteMapResolveEventArgs usando os objetos HttpContext e SiteMapProvider especificados.

Propriedades

Context	Obtém o contexto da solicitação de página que o nó solicitado representa.
Provider	Obtém o objeto SiteMapProvider que gerou o evento SiteMapResolve.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• SiteMapResolveEventHandler
• SiteMapResolve