Condividi tramite


Cenni preliminari sul controllo server Web SiteMapPath

Aggiornamento: novembre 2007

Il controllo SiteMapPath visualizza un percorso di spostamento che indica all'utente la posizione della pagina corrente e contiene i collegamenti alle pagine più in alto nella gerarchia del sito, fino alla home page.

Vengono illustrati i seguenti argomenti:

  • Informazioni di supporto

  • Esempi di codice

  • Riferimento alle classi

Informazioni di supporto

Il controllo SiteMapPath ottiene i dati di spostamento da una mappa del sito. Questi dati comprendono le informazioni sulle pagine del sito Web, ad esempio l'URL, il titolo, la descrizione e la posizione nella gerarchia di spostamento. L'archiviazione dei dati di spostamento in un unico controllo semplifica l'aggiunta e la rimozione di elementi nei menu di spostamento di un sito Web.

Nell'esempio di codice riportato di seguito sono indicati i dati della mappa del sito contenuti in un file Web.sitemap.

<siteMap>
  <siteMapNode title="Home" description="Home" url="~/default.aspx" >
    <siteMapNode title="Services" description="Services we offer" 
      url="~/Services.aspx">
    <siteMapNode title="Training" description="Training classes" 
      url="~/Training.aspx" />
    <siteMapNode title="Consulting" description="Consulting services" 
      url="~/Consulting.aspx" />
    </siteMapNode>
  </siteMapNode>
</siteMap>
Nota:

I dati di spostamento definiti nel controllo SiteMapPath possono essere visualizzati soltanto nelle pagine elencate nella mappa del sito. Se si inserisce un controllo SiteMapPath in una pagina non elencata nella mappa, le informazioni generate da tale controllo non verranno visualizzate dal client.

È possibile aggiungere un controllo SiteMapPath alla pagina Training.aspx includendo il seguente codice.

<asp:SiteMapPath ID="SiteMapPath1" Runat="server"></asp:SiteMapPath>

Quando la pagina Training.aspx viene aperta nel browser, il controllo SiteMapPath visualizza un percorso simile a quello riportato di seguito, dove Home e Services sono indicati come collegamenti ipertestuali:

        Home > Services > Training

Il controllo SiteMapPath può essere utilizzato per definire il percorso di spostamento nel sito senza scrivere codice né associare dati. Il controllo è in grado di leggere le informazioni della mappa del sito ed eseguirne il rendering in modo automatico. È tuttavia possibile utilizzare SiteMapPath anche per modificare i dati della mappa del sito. Per ulteriori informazioni, vedere Procedura: modificare a livello di codice i nodi della mappa del sito in memoria.

Il controllo SiteMapPath consente agli utenti di spostarsi all'indietro, ovvero dalla pagina corrente a quelle di livello superiore nella gerarchia del sito, ma non di spostarsi in avanti, ovvero dalla pagina corrente a un'altra pagina di livello inferiore nella gerarchia del sito. Ad esempio, è possibile utilizzare il controllo SiteMapPath in applicazioni basate su newsgroup o aree di discussione per consentire agli utenti di conoscere il percorso dell'articolo attualmente visualizzato.

Esempi di codice

Procedura: aggiungere l'esplorazione semplice di siti

Procedura: personalizzare l'aspetto dei controlli server Web SiteMapPath

Procedura: configurare più mappe del sito e provider di mappa del sito

Torna all'inizio

Riferimento alle classi

Nella tabella riportata di seguito sono elencate le classi correlate al controllo SiteMapPath.

Membro

Descrizione

SiteMapPath

Classe principale del controllo.

Torna all'inizio

Vedere anche

Attività

Procedura: personalizzare l'aspetto dei controlli server Web SiteMapPath

Procedura: filtrare i nodi recuperati dai controlli server Web SiteMapDataSource

Concetti

Cenni preliminari sugli spostamenti all'interno dei siti ASP.NET

Protezione del sistema di spostamento all'interno dei siti ASP.NET

Protezione dell'accesso ai dati

Riferimenti

SiteMapPath

XmlSiteMapProvider

Altre risorse

Protezione delle applicazioni ASP.NET in ambienti host