Elemento siteMap (schema delle impostazioni ASP.NET)

  • Articolo

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Definisce le impostazioni di configurazione per supportare l'infrastruttura di navigazione per configurare, archiviare e visualizzare i siti durante la navigazione.

Questo elemento è nuovo in .NET Framework versione 2.0.

<siteMap
  defaultProvider="provider name">
  <providers>...</providers> 
</siteMap>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo

Descrizione

defaultProvider

Attributo obbligatorio.

Specifica il nome del provider.

L'impostazione predefinita è il provider XmlSiteMapProvider.

Elementi figlio

Elemento

Descrizione

providers

Definisce una raccolta di provider di navigazione.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento radice per la sezione di configurazione ASP.NET.

Note

Configurazione predefinita

L'elemento siteMap predefinito riportato di seguito è configurato nel file Web.config a livello di radice in .NET Framework versione 2.0.

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere un provider della mappa del sito nel file Web.config per eseguire l'override di quello predefinito, definito per ASP.NET.

<configuration>
  <system.web>
    <siteMap defaultProvider="XmlSiteMapReader">
      <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>

Informazioni sull'elemento

Gestore della sezione di configurazione

System.Web.Configuration.SiteMapSection

Membro di configurazione

SystemWebSectionGroup.SiteMap

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 2.0

Microsoft Visual Studio 2005

Vedere anche

Attività

How to: Lock ASP.NET Configuration Settings

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento <Configuration>

Elemento providers per siteMap (schema delle impostazioni ASP.NET)

System.Configuration

System.Web.Configuration

Concetti

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Altre risorse

ASP.NET Configuration Files

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

ASP.NET Configuration API