Condividi tramite


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

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

Aggiunge un provider alla raccolta di provider di navigazione.

Questo elemento è nuovo in .NET Framework versione 2.0.

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo

Descrizione

description

Attributo String obbligatorio.

Descrive il provider della mappa del sito.

name

Attributo String obbligatorio.

Specifica il nome del provider da aggiungere.

siteMapFile

Attributo String facoltativo.

Specifica il file in cui si trovano i dati della mappa del sito. Il riferimento siteMapFile può essere costituito da uno degli elementi seguenti:

  • Un riferimento a un percorso relativo all'applicazione (ad esempio ~/SiteMapFile1.sitemap).

  • Un percorso virtuale associato a una posizione interna alla struttura di directory per l'applicazione (ad esempio /directory1/directory2/SiteMapFile1.sitemap).

  • Un riferimento a un percorso relativo alla directory radice della struttura per l'applicazione (ad esempio SiteMapFile1.sitemap).

type

Attributo String obbligatorio.

Specifica un tipo che implementa la classe ProviderBase.

È necessario che il valore type sia un riferimento a un assembly completo.

securityTrimmingEnabled

Il valore predefinito è false.

Se l'attributo è impostato su true, e se il provider include la logica necessaria, il provider della mappa del sito esegue una verifica di ruolo in base ai nodi recuperati e all'utente corrente. Vengono applicate le regole di autorizzazione basate sull'URL per l'applicazione e, se viene utilizzata l'autenticazione di Microsoft Windows, vengono applicate anche le regole di autorizzazione file per l'applicazione.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

Fornisce l'elemento di primo livello 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.

siteMap

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

providers

Definisce una raccolta di provider di navigazione.

Note

Configurazione predefinita

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

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

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

SiteMapSection.Providers

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 providers per siteMap (schema delle impostazioni ASP.NET)

Elemento siteMap (schema delle impostazioni ASP.NET)

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

Elemento <Configuration>

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

Elemento remove per 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