Compartilhar via


Adicionar elemento para provedores de mapa do site (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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"
/>

Attributes and Elements

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

Attributes

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 um dos seguintes procedimentos:

  • 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órios para o 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 do site executa 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 para o aplicativo são aplicadas e se está sendo usada a autenticação do Microsoft Windows, as regras de autorização de arquivo para o aplicativo também se aplicam.

Child Elements

Nenhum.

Parent Elements

Elemento

Descrição

configuration

Fornece o elemento raiz em cada arquivo de configuração que é usado pelo common language runtime e o.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.

Remarks

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>

Element Information

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

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0 5.1 ou 6.0

A.NET Framework versão 2.0

Microsoft Visual Studio 2005

Consulte também

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

Elemento de provedores de mapa do site (ASP.NET Settings Schema)

siteMap Element (ASP.NET Settings Schema)

System. Web Element (ASP.NET Settings Schema)

<configuration> Elemento

Desmarque o elemento para provedores de mapa do site (ASP.NET Settings Schema)

Remover elemento para provedores de mapa do site (ASP.NET Settings Schema)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Other Resources

ASP.NET Configuration Files

ASP.Definições de configuração de rede

Configurações gerais (ASP.NET)

ASP.NET Configuration API