Controllo SiteMapPath

Il controllo SiteMapPath consente di visualizzare un percorso di spostamento che indica all'utente la posizione della pagina corrente e contiene i collegamenti alle pagine di livello più alto nella gerarchia del sito, fino alla home page. Sono disponibili diverse opzioni per la personalizzazione dell'aspetto dei collegamenti.

Per aggiungere un controllo SiteMapPath a una pagina

• Trascinare il controllo SiteMapPath dal pannello Casella degli strumenti nella pagina.

Il controllo SiteMapPath ottiene i dati di spostamento da una mappa del sito. Tali dati comprendono le informazioni sulle pagine del sito, ad esempio l'URL, il titolo, la descrizione e la posizione nella gerarchia di spostamento. L'utilizzo di un unico controllo per l'archiviazione dei dati di spostamento consente di semplificare l'aggiunta e la rimozione di elementi nei menu di spostamento del sito. Per ulteriori informazioni sulle mappe del sito, vedere Mappe del sito ASP.NET  in MSDN Library.

Il modo più semplice per creare una mappa del sito prevede la creazione di un file XML denominato Web.sitemap, che organizza le pagine nel sito su base gerarchica. Questa mappa del sito viene automaticamente prelevata dal provider di mappe del sito predefinito per ASP.NET. Il file Web.sitemap deve trovarsi nella cartella principale dell'applicazione.

[!NOTA]

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

Una semplice mappa del sito in un file Web.sitemap può avere un aspetto simile al seguente:

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

Per applicare schemi di formattazione di base al controllo SiteMapPath

1. Nella visualizzazione Progettazione fare clic con il pulsante destro del mouse sul controllo Login e quindi scegliere Mostra attività controlli comuni.

   [!NOTA]

   È inoltre possibile fare clic sul controllo Login nella visualizzazione Progettazione e quindi sulla freccia nell'angolo superiore destro per visualizzare il menu Attività comuni di Login. Fare di nuovo clic sulla freccia per nascondere il menu.

2. Scegliere Formattazione automatica dal menu Attività comuni di SiteMapPath.

3. Nella finestra di dialogo Formattazione automatica selezionare uno degli schemi disponibili nell'elenco Selezionare uno schema. L'effetto dello schema sul controllo SiteMapPath viene visualizzato nell'area Anteprima.

4. Fare clic su OK per applicare lo schema di formattazione e chiudere la finestra di dialogo oppure fare clic su Applica per applicare lo schema di formattazione senza chiudere la finestra di dialogo.

È inoltre possibile applicare formattazione e stili e modificare il testo in modo interattivo al controllo SiteMapPath.

Per ulteriori informazioni su tutte le proprietà del controllo SiteMapPath, vedere Membri SiteMapPath  in MSDN Library.

Il controllo SiteMapPath è costituito da varie aree modello che possono essere progettate in modo interattivo.

Per progettare un modello in modo interattivo

1. Nella visualizzazione Progettazione fare clic con il pulsante destro del mouse sul controllo SiteMapPath e quindi scegliere Mostra attività controlli comuni.

2. Scegliere Modifica modelli dal menu Attività comuni di SiteMapPath. Per il controllo Wizard verrà attivata la modalità di modifica dei modelli.

3. Nella casella di riepilogo a discesa Visualizza selezionare il modello che si desidera modificare.

4. Aggiungere testo o controlli o apportare modifiche al modello.

5. Al termine della progettazione dei modelli, scegliere Fine modifica modelli dal menu Attività comuni di SiteMapPath per tornare alla modalità di progettazione standard di SiteMapPath.

Il controllo SiteMapPath consente agli utenti di passare a posizioni precedenti, ovvero dalla pagina corrente a pagine di livello più alto nella gerarchia del sito. Il controllo SiteMapPath, tuttavia, non consente di passare a posizioni successive, ovvero dalla pagina corrente a una pagina di livello inferiore nella gerarchia del sito. È possibile, ad esempio, utilizzare il controllo SiteMapPath in applicazioni di newsgroup o bacheche per consentire agli utenti di vedere il percorso dell'articolo visualizzato al momento.

Il controllo SiteMapPath può essere utilizzato per creare una struttura di esplorazione del sito senza codice e senza associazione di dati. Il controllo può leggere ed eseguire il rendering delle informazioni della mappa del sito automaticamente. Se necessario, tuttavia, è possibile utilizzare il controllo SiteMapPath per modificare i dati della mappa del sito. Per ulteriori informazioni, vedere Procedura: modifica programmatica di nodi di mappa del sito in memoria  in MSDN Library.

Vedere anche

Concetti

Controlli di spostamento ASP.NET
Controllo Menu
Controllo TreeView