Ler em inglês

Partilhar via


SiteMapProvider Classe

Definição

Fornece uma classe base comum para todos os provedores de dados de mapa do site, bem como uma maneira para os desenvolvedores implementarem provedores de dados de mapa do site personalizados que podem ser usados com a infra-estrutura de mapa de site ASP.NET como armazenamentos persistentes pata objetos SiteMap.

C#
public abstract class SiteMapProvider : System.Configuration.Provider.ProviderBase
Herança
SiteMapProvider
Derivado

Exemplos

O exemplo de código a seguir demonstra como escrever uma classe que implementa a classe abstrata SiteMapProvider . Este exemplo inclui apenas um exemplo SiteMapProvider e um arquivo de texto de exemplo que funciona com ele. Para executar o exemplo, você também precisa de uma entrada no arquivo Web.config e uma página de .aspx. Você pode encontrá-los na documentação da SiteMapDataSource.SiteMapProvider propriedade .

O exemplo usa um arquivo delimitado por vírgulas que segue uma estrutura esperada para carregar informações de sitemap. A primeira linha do arquivo representa o nó raiz do sitemap e as linhas subsequentes são subnodos. Cada subnodo identifica seu nó pai por URL. Um exemplo de um arquivo que atende a esses critérios é mostrado abaixo.

default.aspx,Home,MyCompany Home Page,  
sale.aspx,Now On Sale,Check Out These Great Deals!,default.aspx  
catalog.aspx,Online Catalog,Browse Our Many Great Items!,default.aspx  

O SimpleTextSiteMapProvider fornece implementações de exemplo de todas as SiteMapProvider propriedades e métodos.

C#
using System;
using System.Configuration.Provider;
using System.Collections;
using System.Collections.Specialized;
using System.IO;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS
{

  [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
  public class SimpleTextSiteMapProvider : SiteMapProvider
  {
    private SiteMapProvider parentSiteMapProvider = null;
    private string simpleTextProviderName = null;
    private string sourceFilename = null;
    private SiteMapNode rootNode = null;
    private ArrayList siteMapNodes = null;
    private ArrayList childParentRelationship = null;

    // A default constructor. The Name property is initialized in the
    // Initialize method.
    public SimpleTextSiteMapProvider()
    {
    }
    // 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 ParentProvider property.
    public override SiteMapProvider ParentProvider
    {
      get
      {
        return parentSiteMapProvider;
      }
      set
      {
        parentSiteMapProvider = value;
      }
    }

    // Implement the RootProvider property.
    public override SiteMapProvider RootProvider
    {
      get
      {
        // If the current instance belongs to a provider hierarchy, it
        // cannot be the RootProvider. Rely on the ParentProvider.
        if (this.ParentProvider != null)
        {
          return ParentProvider.RootProvider;
        }
        // If the current instance does not have a ParentProvider, it is
        // not a child in a hierarchy, and can be the RootProvider.
        else
        {
          return this;
        }
      }
    }
    // Implement the FindSiteMapNode method.
    public override SiteMapNode FindSiteMapNode(string rawUrl)
    {

      // Does the root node match the URL?
      if (RootNode.Url == rawUrl)
      {
        return RootNode;
      }
      else
      {
        SiteMapNode candidate = null;
        // Retrieve the SiteMapNode that matches the URL.
        lock (this)
        {
          candidate = GetNode(siteMapNodes, rawUrl);
        }
        return candidate;
      }
    }
    // Implement the GetChildNodes method.
    public override SiteMapNodeCollection GetChildNodes(SiteMapNode node)
    {
      SiteMapNodeCollection children = new SiteMapNodeCollection();
      // Iterate through the ArrayList and find all nodes that have the specified node as a parent.
      lock (this)
      {
        for (int i = 0; i < childParentRelationship.Count; i++)
        {

          string nodeUrl = ((DictionaryEntry)childParentRelationship[i]).Key as string;

          SiteMapNode parent = GetNode(childParentRelationship, nodeUrl);

          if (parent != null && node.Url == parent.Url)
          {
            // The SiteMapNode with the Url that corresponds to nodeUrl
            // is a child of the specified node. Get the SiteMapNode for
            // the nodeUrl.
            SiteMapNode child = FindSiteMapNode(nodeUrl);
            if (child != null)
            {
              children.Add(child as SiteMapNode);
            }
            else
            {
              throw new Exception("ArrayLists not in sync.");
            }
          }
        }
      }
      return children;
    }
    protected override SiteMapNode GetRootNodeCore()
    {
      return RootNode;
    }
    // Implement the GetParentNode method.
    public override SiteMapNode GetParentNode(SiteMapNode node)
    {
      // Check the childParentRelationship table and find the parent of the current node.
      // If there is no parent, the current node is the RootNode.
      SiteMapNode parent = null;
      lock (this)
      {
        // Get the Value of the node in childParentRelationship
        parent = GetNode(childParentRelationship, node.Url);
      }
      return parent;
    }

    // Implement the ProviderBase.Initialize property.
    // Initialize is used to initialize the state that the Provider holds, but
    // not actually build the site map.
    public override void Initialize(string name, NameValueCollection attributes)
    {

      lock (this)
      {

        base.Initialize(name, attributes);

        simpleTextProviderName = name;
        sourceFilename = attributes["siteMapFile"];
        siteMapNodes = new ArrayList();
        childParentRelationship = new ArrayList();

        // Build the site map in memory.
        LoadSiteMapFromStore();
      }
    }
    // Private helper methods

    private SiteMapNode GetNode(ArrayList list, string url)
    {
      for (int i = 0; i < list.Count; i++)
      {
        DictionaryEntry item = (DictionaryEntry)list[i];
        if ((string)item.Key == url)
          return item.Value as SiteMapNode;
      }
      return null;
    }

    // Get the URL of the currently displayed page.
    private string FindCurrentUrl()
    {
      try
      {
        // The current HttpContext.
        HttpContext currentContext = HttpContext.Current;
        if (currentContext != null)
        {
          return currentContext.Request.RawUrl;
        }
        else
        {
          throw new Exception("HttpContext.Current is Invalid");
        }
      }
      catch (Exception e)
      {
        throw new NotSupportedException("This provider requires a valid context.",e);
      }
    }
    protected virtual void LoadSiteMapFromStore()
    {
      string pathToOpen;

      lock (this)
      {
        // If a root node exists, LoadSiteMapFromStore has already
        // been called, and the method can return.
        if (rootNode != null)
        {
          return;
        }
        else
        {
          pathToOpen = HttpContext.Current.Server.MapPath("~" + "\\" + sourceFilename);

          if (File.Exists(pathToOpen))
          {
            // Open the file to read from.
            using (StreamReader sr = File.OpenText(pathToOpen))
            {

              // Clear the state of the collections and rootNode
              rootNode = null;
              siteMapNodes.Clear();
              childParentRelationship.Clear();

              // Parse the file and build the site map
              string s = "";
              string[] nodeValues = null;
              SiteMapNode temp = null;

              while ((s = sr.ReadLine()) != null)
              {

                // Build the various SiteMapNode objects and add
                // them to the ArrayList collections. The format used
                // is: URL,TITLE,DESCRIPTION,PARENTURL

                nodeValues = s.Split(',');

                temp = new SiteMapNode(this,
                    HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                    HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0],
                    nodeValues[1],
                    nodeValues[2]);

                // Is this a root node yet?
                if (null == rootNode &&
                    string.IsNullOrEmpty(nodeValues[3]))
                {
                  rootNode = temp;
                }

              // If not the root node, add the node to the various collections.
                else
                {
                  siteMapNodes.Add(new DictionaryEntry(temp.Url, temp));
                  // The parent node has already been added to the collection.
                  SiteMapNode parentNode =
                           FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[3]);
                  if (parentNode != null)
                  {
                    childParentRelationship.Add(new DictionaryEntry(temp.Url, parentNode));
                  }
                  else
                  {
                    throw new Exception("Parent node not found for current node.");
                  }
                }
              }
            }
          }
          else
          {
            throw new Exception("File not found");
          }
        }
      }
      return;
    }
  }
}

Comentários

As StaticSiteMapProvider classes e XmlSiteMapProvider representam as implementações padrão da classe abstrata SiteMapProvider . O XmlSiteMapProvider usa um arquivo XML chamado Web.sitemap para armazenar dados do mapa do site. Para obter mais informações sobre o arquivo Web.sitemap, consulte ASP.NET Mapas de Sites.

A SiteMapProvider classe dá suporte ao conceito de uma hierarquia de provedor de mapa de sites, declarando as RootProvider propriedades e ParentProvider . Um SiteMapProvider pode ser um filho ou pai de outro provedor. Isso permite cenários em que diferentes áreas de conteúdo de um site são de propriedade ou implementadas por diferentes grupos de desenvolvimento que mantêm seus próprios mapas de sites e provedores de mapa de sites.

Todos os SiteMapProvider objetos são configurados nos arquivos Web.config. Todos os provedores de mapa de site declarados nesses arquivos de configuração são carregados em tempo de execução e são usados para carregar e processar dados de navegação do site. O SiteMap objeto , que controla todos os provedores que estão disponíveis para ele por meio de sua Providers coleção de propriedades, fornece acesso programático aos dados de navegação gerenciados pelos provedores. O exemplo de código a seguir demonstra o formato usado para declarar um provedor de mapa de site em um arquivo Web.config.

<siteMap defaultProvider="<name>">  
  <providers>  
    <add  
      name="<friendly name>"  
      type="<fully qualified class name>, <assembly name (optional)>"   
      siteMapFile = "<file name>" />  
  </providers>  
</siteMap>  

Os dados de navegação do site carregados por esses provedores são usados por outros componentes da infraestrutura de mapa do site, como os SiteMapPath controles e TreeView , para exibir informações do mapa do site para os usuários.

Se você implementar seu próprio provedor de mapa de site, poderá colocar o arquivo de origem no diretório App_Code do aplicativo ASP.NET e, em seguida, o assembly será compilado automaticamente. Você também pode colocar seu próprio provedor de mapa de site no GAC (Cache de Assembly Global) e fornecer uma referência totalmente qualificada a ele no arquivo Web.config. Para obter mais informações sobre serviços do compilador, consulte Trabalhando com assemblies e o Cache de Assembly Global.

Notas aos Implementadores

Ao herdar da SiteMapProvider classe , você deve substituir os seguintes membros: GetRootNodeCore(), FindSiteMapNode(String), GetChildNodes(SiteMapNode)e GetParentNode(SiteMapNode).

Construtores

SiteMapProvider()

Inicializa uma nova instância da classe SiteMapProvider.

Propriedades

CurrentNode

Obtém o objeto SiteMapNode que representa a página atualmente solicitada.

Description

Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).

(Herdado de ProviderBase)
EnableLocalization

Obtém ou define um valor booliano que indica se os valores localizados dos atributos SiteMapNode são retornados.

Name

Obtém o nome amigável usado para referir-se ao provedor durante a configuração.

(Herdado de ProviderBase)
ParentProvider

Obtém ou define o objeto SiteMapProvider pai do provedor atual.

ResourceKey

Obtém ou define a chave de recursos usada para localizar atributos SiteMapNode.

RootNode

Obtém o objeto SiteMapNode raiz dos dados do mapa de site que o provedor atual representa.

RootProvider

Obtém o objeto SiteMapProvider raiz na hierarquia de provedores atuais.

SecurityTrimmingEnabled

Obtém um valor booliano que indica se um provedor de mapa de site filtra nós do mapa de site com base em uma função do usuário.

Métodos

AddNode(SiteMapNode)

Adiciona um objeto SiteMapNode à coleção de nós mantida pelo provedor do mapa do site.

AddNode(SiteMapNode, SiteMapNode)

Adiciona um objeto SiteMapNode à coleção de nós mantida pelo provedor de mapa de site e especifica o objeto pai SiteMapNode.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindSiteMapNode(HttpContext)

Recupera um objeto SiteMapNode que representa a página solicitada no momento usando o objeto HttpContext especificado.

FindSiteMapNode(String)

Quando substituída em uma classe derivada, recupera um objeto SiteMapNode que representa a página na URL especificada.

FindSiteMapNodeFromKey(String)

Recupera um objeto SiteMapNode com base em uma chave especificada.

GetChildNodes(SiteMapNode)

Quando substituído em uma classe derivada, recupera os nós filho de um SiteMapNode específico.

GetCurrentNodeAndHintAncestorNodes(Int32)

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar o nó para a página solicitada no momento e ao buscar os nós de mapa de site pai e ancestral para a página atual.

GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar o nó para a página solicitada no momento e ao buscar os nós de mapa de site na proximidade do nó atual.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetParentNode(SiteMapNode)

Quando substituído em uma classe derivada, recupera o nó pai de um objeto SiteMapNode específico.

GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar um nó ancestral para a página solicitada no momento e ao buscar os nós descendentes para o ancestral.

GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar um nó ancestral para o objeto SiteMapNode especificado e ao buscar seus nós filho.

GetRootNodeCore()

Quando substituído em uma classe derivada, recupera o nó raiz de todos os nós gerenciados no momento pelo provedor atual.

GetRootNodeCoreFromProvider(SiteMapProvider)

Recupera o nó raiz de todos os nós gerenciados no momento pelo provedor de mapa de site especificado.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HintAncestorNodes(SiteMapNode, Int32)

Fornece um método que os provedores de mapa de site podem substituir para executar uma recuperação otimizada de um ou mais níveis de nós pai e ancestrais, relativos ao objeto SiteMapNode especificado.

HintNeighborhoodNodes(SiteMapNode, Int32, Int32)

Fornece um método que os provedores de mapa de site podem substituir para executar uma recuperação de nós otimizada localizada na proximidade do nó especificado.

Initialize(String, NameValueCollection)

Inicializa a implementação SiteMapProvider, incluindo todos os recursos necessários para carregar os dados de mapa do site do armazenamento persistente.

IsAccessibleToUser(HttpContext, SiteMapNode)

Recupera o valor booliano que indica se o objeto SiteMapNode especificado pode ser exibido pelo usuário no contexto especificado.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RemoveNode(SiteMapNode)

Remove o objeto SiteMapNode especificado da coleção de nós mantida pelo provedor de mapa do site.

ResolveSiteMapNode(HttpContext)

Aciona o evento SiteMapResolve.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

SiteMapResolve

Ocorre quando a propriedade CurrentNode é chamada.

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também