Partilhar via


Adicionar elemento para provedores de mapa do site (ASP.NET Configurações Schema)

Adiciona um provedor a coleção de provedores de navegação.

Esse elemento é novo no .NET Framework versão 2.0.

<add  
   name="provider name" 
   type="provider type"
   description="description"
   siteMapFile="path"
/>

Atributos e elementos

As seções a seguir descrevem os atributos, elementos filho e elementos pai.

Atributos

Atributo

Descrição

description

Obrigatório String atributo.

Descreve o provedor de mapa do site.

name

Obrigatório String atributo.

Especifica o nome do provedor para adicionar.

siteMapFile

Opcional String atributo.

Especifica o arquivo que contém os dados de mapa do site. O siteMapFile referência pode ser qualquer uma das seguintes opções:

  • Uma referência de caminho é relativo ao aplicativo (por exemplo, ~/SiteMapFile1.sitemap).

  • Um caminho virtual que mapeia para um local que está dentro da estrutura de diretório do aplicativo (por exemplo, /directory1/directory2/SiteMapFile1.sitemap).

  • Uma referência de caminho é relativo à raiz da estrutura de diretório do aplicativo (por exemplo, SiteMapFile1.sitemap).

type

Obrigatório String atributo.

Especifica um tipo que implementa o ProviderBase classe.

O type o valor deve ser uma referência de assembly totalmente qualificado.

securityTrimmingEnabled

O padrão é false.

Se true, e se o provedor inclui a lógica necessária, o provedor de mapa de site realiza uma verificação de função em relação a nós recuperados. O provedor também executa uma verificação de função em relação ao usuário atual. As regras de autorização de URL do aplicativo são aplicadas e a autenticação do Microsoft Windows está sendo usada, as regras de autorização de arquivo para o aplicativo também se aplicam.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Fornece o elemento raiz em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Seção de configuração de rede.

siteMap

Define as configurações para suportar a infra-estrutura de navegação para configurar, armazenar e processar navegação do site.

providers

Define uma coleção de provedores de navegação.

Comentários

Configuração padrão

O seguinte padrão add elemento é configurado no arquivo Web. config raiz na.NET Framework versão 2.0.

<add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
     type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral, 
     PublicKeyToken=b03f5f7f11d50a3a" />

Exemplo

O exemplo de código a seguir mostra como adicionar um provedor de mapa do site no arquivo Web. config para substituir o provedor de mapa de site padrão está definido para o ASP.NET.

<configuration>
  <system.web>
    <siteMap>
      <providers>
        <add 
          name="XmlSiteMapReader"
          type="XmlSiteMapProvider, System.Web, Version=1.1.3300.0,
                Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
          siteMapFile="my.sitemap"
          description="XmlSiteMapProvider that loads my.sitemap"/>
      </providers>
      <siteMap>
  </system.web>
</configuration>

Informações do elemento

Manipulador da seção de configuração

System.Web.Configuration.SiteMapSection

Membro de configuração

SiteMapSection.Providers

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Requisitos

De da (IIS) versão 5.0 5.1 ou 6.0

A.NET Framework versão 2.0

Microsoft Visual Studio 2005

Consulte também

Tarefas

Como: Bloquear definições de configuração ASP.NET

Referência

Elemento de provedores de mapa do site (ASP.NET Configurações Schema)

siteMap Element (ASP.NET Settings Schema)

system.web Element (ASP.NET Settings Schema)

<configuration> Element

Desmarque o elemento para provedores de mapa do site (ASP.NET Configurações Schema)

Remover elemento para provedores de mapa do site (ASP.NET Configurações Schema)

System.Configuration

System.Web.Configuration

Conceitos

Visão geral da configuração ASP.NET

Controles de servidor Web do ASP.NET e recursos do navegador

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET

ASP.NET Configuration Settings

General Configuration Settings (ASP.NET)

API de Configuração do ASP.NET