Condividi tramite

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

  • Articolo

Aggiornamento: novembre 2007

Aggiunge un provider all'insieme di provider di esplorazione.

Questo elemento è nuovo in .NET Framework versione 2.0.

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento siteMap (schema delle impostazioni ASP.NET)
      Elemento providers per siteMap (schema delle impostazioni ASP.NET)
        Elemento add per providers per siteMap (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed 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 principale 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

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

siteMap

Consente di definire le impostazioni di configurazione per supportare l'infrastruttura di esplorazione per configurare, archiviare e visualizzare i siti durante l'esplorazione.

providers

Consente di definire un insieme di provider di esplorazione.

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à

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulla configurazione di ASP.NET

Controlli server Web ASP.NET e funzionalità del browser

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

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

Altre risorse

File di configurazione ASP.NET

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

API di configurazione di ASP.NET