Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese
Questa documentazione è stata archiviata e non viene gestita.

Classe SiteMapPath

Visualizza un set di testi o immagini con collegamenti ipertestuali che consentono agli utenti di spostarsi più facilmente all'interno di un sito, pur occupando una quantità minima di spazio nella pagina.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public class SiteMapPath : CompositeControl
<asp:SiteMapPath />

Il tipo SiteMapPath espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoSiteMapPathInizializza una nuova istanza della classe SiteMapPath.
In alto

  NomeDescrizione
Proprietà pubblicaAccessKeyOttiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Proprietà protetta.AdapterOttiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
Proprietà pubblicaAppRelativeTemplateSourceDirectoryOttiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Proprietà pubblicaAttributesOttiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
Proprietà pubblicaBackColorOttiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaBindingContainerInfrastruttura. Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
Proprietà pubblicaBorderColorOttiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
Proprietà pubblicaBorderStyleOttiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaBorderWidthOttiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
Proprietà protetta.ChildControlsCreatedOttiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
Proprietà pubblicaClientIDOttiene l'ID controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
Proprietà pubblicaClientIDModeOttiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
Proprietà protetta.ClientIDSeparatorOttiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Proprietà protetta.ContextOttiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Proprietà pubblicaControlsOttiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl. (Ereditato da CompositeControl)
Proprietà pubblicaControlStyleOttiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà pubblicaControlStyleCreatedOttiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà pubblicaCssClassOttiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
Proprietà pubblicaCurrentNodeStyleOttiene lo stile utilizzato per il testo visualizzato del nodo corrente.
Proprietà pubblicaCurrentNodeTemplateOttiene o imposta un modello di controllo da utilizzare per il nodo di un percorso di spostamento nel sito che rappresenta la pagina attualmente visualizzata.
Proprietà pubblicaDataItemContainerOttiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
Proprietà pubblicaDataKeysContainerOttiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
Proprietà protetta.DesignModeOttiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Proprietà pubblicaEnabledOttiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
Proprietà pubblicaEnableThemingOttiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
Proprietà pubblicaEnableViewStateOttiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. (Ereditato da Control)
Proprietà protetta.EventsOttiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è in sola lettura. (Ereditato da Control)
Proprietà pubblicaFontOttiene le proprietà del carattere associate al controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaForeColorOttiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaHasAttributesOttiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
Proprietà protetta.HasChildViewStateOttiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Proprietà pubblicaHeightOttiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaIDOttiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
Proprietà protetta.IdSeparatorInfrastruttura. Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
Proprietà protetta.IsChildControlStateClearedOttiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
Proprietà protetta.IsEnabledOttiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
Proprietà protetta.IsTrackingViewStateOttiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
Proprietà protetta.IsViewStateEnabledOttiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
Proprietà protetta.LoadViewStateByIDOttiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
Proprietà pubblicaNamingContainerOttiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà Control.ID. (Ereditato da Control)
Proprietà pubblicaNodeStyleOttiene lo stile utilizzato per il testo visualizzato di tutti i nodi del percorso di spostamento nel sito.
Proprietà pubblicaNodeTemplateOttiene o imposta un modello di controllo da utilizzare per tutti i nodi funzionali di un percorso di spostamento nel sito.
Proprietà pubblicaPageOttiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Proprietà pubblicaParentOttiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
Proprietà pubblicaParentLevelsDisplayedOttiene o imposta il numero di livelli di nodi padre visualizzati dal controllo rispetto al nodo attualmente visualizzato.
Proprietà pubblicaPathDirectionOttiene o imposta l'ordine di esecuzione del rendering dei nodi del percorso di spostamento.
Proprietà pubblicaPathSeparatorOttiene o imposta la stringa che delimita i nodi SiteMapPath nel percorso di spostamento di cui viene eseguito il rendering.
Proprietà pubblicaPathSeparatorStyleOttiene lo stile utilizzato per la stringa di PathSeparator.
Proprietà pubblicaPathSeparatorTemplateOttiene o imposta un modello di controllo da utilizzare per il delimitatore di percorso di un percorso di spostamento nel sito.
Proprietà pubblicaProviderOttiene o imposta un oggetto SiteMapProvider associato al controllo server Web.
Proprietà pubblicaRenderCurrentNodeAsLinkIndica se il nodo di spostamento nel sito che rappresenta la pagina attualmente visualizzata viene rappresentato come collegamento ipertestuale.
Proprietà pubblicaRenderingCompatibilityOttiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
Proprietà pubblicaRootNodeStyleOttiene lo stile del testo visualizzato del nodo radice.
Proprietà pubblicaRootNodeTemplateOttiene o imposta un modello di controllo da utilizzare per il nodo radice di un percorso di spostamento nel sito.
Proprietà pubblicaShowToolTipsOttiene o imposta un valore che indica se il controllo SiteMapPath scrive un attributo di collegamento ipertestuale aggiuntivo per i nodi di spostamento con collegamenti ipertestuali. A seconda del supporto sul client, quando si passa il mouse su un collegamento ipertestuale per cui è stato impostato l'attributo aggiuntivo, viene visualizzata una descrizione comando.
Proprietà pubblicaSiteOttiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
Proprietà pubblicaSiteMapProviderOttiene o imposta il nome dell'oggetto SiteMapProvider utilizzato per il rendering del controllo di spostamento nel sito.
Proprietà pubblicaSkinIDOttiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl)
Proprietà pubblicaSkipLinkTextOttiene o imposta un valore utilizzato per il rendering di testo alternativo in modo che le utilità per la lettura dello schermo ignorino il contenuto del controllo.
Proprietà pubblicaStyleOttiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaSupportsDisabledAttributeOttiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false. (Ereditato da CompositeControl)
Proprietà pubblicaTabIndexOttiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
Proprietà protetta.TagKeyOttiene il valore HtmlTextWriterTag corrispondente a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà protetta.TagNameOttiene il nome del tag del controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà pubblicaTemplateControlOttiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
Proprietà pubblicaTemplateSourceDirectoryOttiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
Proprietà pubblicaToolTipOttiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaUniqueIDOttiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
Proprietà protetta.ViewStateOttiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
Proprietà protetta.ViewStateIgnoresCaseOttiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
Proprietà pubblicaViewStateModeOttiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Proprietà pubblicaVisibleOttiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. (Ereditato da Control)
Proprietà pubblicaWidthOttiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)
In alto

  NomeDescrizione
Metodo protettoAddAttributesToRenderAggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoAddedControlViene chiamato dopo che un controllo è stato aggiunto all'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoAddParsedSubObjectNotifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
Metodo pubblicoApplyStyleCopia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo pubblicoApplyStyleSheetSkinApplica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
Metodo protettoBuildProfileTreeInfrastruttura. Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
Metodo protettoClearCachedClientIDInfrastruttura. Imposta il valore memorizzato nella cache ClientID su null. (Ereditato da Control)
Metodo protettoClearChildControlStateElimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearChildStateElimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearChildViewStateElimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearEffectiveClientIDModeInfrastruttura. Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
Metodo pubblicoCopyBaseAttributesCopia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoCreateChildControlsInfrastruttura. Cancella l'insieme di controlli figlio corrente e lo ricrea chiamando il metodo CreateControlHierarchy. (Esegue l'override di Control.CreateChildControls()).
Metodo protettoCreateControlCollectionCrea un nuovo oggetto ControlCollection per contenere i controlli figlio (letterali e server) del controllo server. (Ereditato da Control)
Metodo protettoCreateControlHierarchyEsamina la struttura della mappa del sito fornita da SiteMapProvider e compila un insieme di controlli figlio basato sugli stili e sui modelli definiti per i nodi funzionali.
Metodo protettoCreateControlStyleCrea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo pubblicoDataBind()Infrastruttura. Associa un'origine dati al controllo SiteMapPath e ai relativi controlli figlio. (Esegue l'override di CompositeControl.DataBind()).
Metodo protettoDataBind(Boolean)Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
Metodo protettoDataBindChildrenAssocia un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Metodo pubblicoDisposeAbilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
Metodo protettoEnsureChildControlsDetermina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
Metodo protettoEnsureIDCrea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Metodo pubblicoEquals(Object)Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoFindControl(String)Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato. (Ereditato da Control)
Metodo protettoFindControl(String, Int32)Infrastruttura. Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Metodo pubblicoFocusImposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
Metodo protettoGetDesignModeStateInfrastruttura. Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblicoGetRouteUrl(Object)Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(RouteValueDictionary)Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(String, Object)Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(String, RouteValueDictionary)Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoGetUniqueIDRelativeToRestituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
Metodo pubblicoHasControlsDetermina se il controllo server contiene controlli figlio. (Ereditato da Control)
Metodo protettoHasEventsRestituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
Metodo protettoInitializeItemInserisce in un oggetto SiteMapNodeItem, ovvero in un controllo server Web che rappresenta un oggetto SiteMapNode, un set di controlli figlio in base alla funzione del nodo, nonché i modelli e gli stili specificati per il nodo.
Metodo protettoIsLiteralContentInfrastruttura. Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
Metodo protettoLoadControlStateRipristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState. (Ereditato da Control)
Metodo protettoLoadViewStateRipristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il metodo SaveViewState. (Esegue l'override di WebControl.LoadViewState(Object)).
Metodo protettoMapPathSecureRecupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoMergeStyleCopia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoOnBubbleEventDetermina se l'evento per il controllo server è passato alla gerarchia del controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
Metodo protettoOnDataBindingInfrastruttura. Esegue l'override del metodo OnDataBinding della classe CompositeControl e genera l'evento DataBinding. (Esegue l'override di Control.OnDataBinding(EventArgs)).
Metodo protettoOnInitGenera l'evento Init. (Ereditato da Control)
Metodo protettoOnItemCreatedGenera l'evento ItemCreated del controllo SiteMapPath.
Metodo protettoOnItemDataBoundGenera l'evento ItemDataBound del controllo SiteMapPath.
Metodo protettoOnLoadGenera l'evento Load. (Ereditato da Control)
Metodo protettoOnPreRenderGenera l'evento PreRender. (Ereditato da Control)
Metodo protettoOnUnloadGenera l'evento Unload. (Ereditato da Control)
Metodo protettoOpenFileOttiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
Metodo protettoRaiseBubbleEventAssegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
Metodo protettoRecreateChildControlsRicrea i controlli figlio in un controllo derivato da CompositeControl. (Ereditato da CompositeControl)
Metodo protettoRemovedControlViene chiamato dopo la rimozione di un controllo figlio dall'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoRenderScrive il contenuto di CompositeControl nell'oggetto HtmlTextWriter specificato, per la visualizzazione sul client. (Esegue l'override di CompositeControl.Render(HtmlTextWriter)).
Metodo pubblicoRenderBeginTagEsegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoRenderChildrenInvia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client. (Ereditato da Control)
Metodo protettoRenderContentsEsegue il rendering dei nodi nel controllo SiteMapPath. (Esegue l'override di WebControl.RenderContents(HtmlTextWriter)).
Metodo pubblicoRenderControl(HtmlTextWriter)Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter fornito e memorizza le informazioni di tracciatura relative al controllo se questa funzionalità è attivata. (Ereditato da Control)
Metodo protettoRenderControl(HtmlTextWriter, ControlAdapter)Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
Metodo pubblicoRenderEndTagEsegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoResolveAdapterOttiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
Metodo pubblicoResolveClientUrlOttiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
Metodo pubblicoResolveUrlConverte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
Metodo protettoSaveControlStateSalva le modifiche allo stato di un controllo server apportate dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da Control)
Metodo protettoSaveViewStateInfrastruttura. Salva le modifiche apportate allo stato di visualizzazione per il controllo SiteMapPath. (Esegue l'override di WebControl.SaveViewState()).
Metodo protettoSetDesignModeStateImposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblicoSetRenderMethodDelegateInfrastruttura. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protettoTrackViewStateInfrastruttura. Tiene traccia delle variazioni dello stato di visualizzazione del controllo SiteMapPath. (Esegue l'override di WebControl.TrackViewState()).
In alto

  NomeDescrizione
Evento pubblicoDataBindingViene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Evento pubblicoDisposedSi verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Evento pubblicoInitViene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Evento pubblicoItemCreatedSi verifica quando un oggetto SiteMapNodeItem viene creato dall'oggetto SiteMapPath e associato al corrispondente oggetto SiteMapNode. Questo evento viene generato dal metodo OnItemCreated.
Evento pubblicoItemDataBoundInfrastruttura. Si verifica dopo che un oggetto SiteMapNodeItem è stato associato ai relativi dati SiteMapNode sottostanti dall'oggetto SiteMapPath. Questo evento viene generato dal metodo OnItemDataBound.
Evento pubblicoLoadViene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
Evento pubblicoPreRenderSi verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Evento pubblicoUnloadViene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
In alto

  NomeDescrizione
Metodo di estensione pubblicoFindDataSourceControlRestituisce l'origine dati associata al controllo dati per il controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoFindFieldTemplateRestituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoFindMetaTableRestituisce l'oggetto metatabella per il controllo contenitore dei dati. (Definito da DynamicDataExtensions).
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.GetAttributeInfrastruttura. Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.SetAttributeImposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
Implementazione esplicita dell'interfacciaMetodo privatoICompositeControlDesignerAccessor.RecreateChildControlsConsente a uno strumento di progettazione di ricreare l'insieme di controlli figlio del controllo composito nell'ambiente di progettazione. (Ereditato da CompositeControl)
Implementazione esplicita dell'interfacciaProprietà privataIControlBuilderAccessor.ControlBuilderPer una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.GetDesignModeStatePer una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.SetDesignModeStatePer una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.SetOwnerControlInfrastruttura. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIControlDesignerAccessor.UserDataPer una descrizione di questo membro, vedere IControlDesignerAccessor.UserData. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIDataBindingsAccessor.DataBindingsPer una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIDataBindingsAccessor.HasDataBindingsPer una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIExpressionsAccessor.ExpressionsPer una descrizione di questo membro, vedere IExpressionsAccessor.Expressions. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIExpressionsAccessor.HasExpressionsPer una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIParserAccessor.AddParsedSubObjectPer una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
In alto

In questo argomento:

Introduzione

SiteMapPath è un controllo di spostamento nel sito che riflette i dati forniti dall'oggetto SiteMap. Offre agli utenti la possibilità di spostarsi facilmente in un sito senza sprecare spazio, oltre a fungere da punto di riferimento per individuare nel sito la posizione della pagina attualmente visualizzata. Questo tipo di controllo, noto anche come "breadcrumb", visualizza un percorso gerarchico dei nomi di pagine con collegamenti ipertestuali tramite il quale è possibile tornare dalla posizione corrente ai livelli superiori della gerarchia di pagine. SiteMapDataSource . SiteMapPath è utile per i siti che hanno una struttura gerarchica di pagine con molti livelli, ma nei quali un oggetto TreeView o Menu potrebbe richiedere eccessivo spazio in una pagina.

Il controllo SiteMapPath interagisce direttamente con i dati della mappa del proprio sito Web. Se viene utilizzato in una pagina non rappresentata nella mappa del sito, non viene visualizzato. Per ulteriori informazioni sulle mappe dei siti, vedere Navigazione all'interno dei siti ASP.NET.

Nodi

SiteMapPath è costituito da nodi. Ciascun elemento del percorso viene indicato come nodo ed è rappresentato da un oggetto SiteMapNodeItem. Il nodo che ancora il percorso e rappresenta la base della struttura ad albero gerarchica è denominato nodo radice. Il nodo che rappresenta la pagina attualmente visualizzata è il nodo corrente. Qualsiasi altro nodo compreso tra il nodo corrente e quello radice è un nodo padre. Nella tabella riportata di seguito sono descritti i tre tipi di nodi supportati.

Tipo di nodo

Oggetto di descrizione

radice

Nodo che ancora un set gerarchico di nodi.

padre

Nodo con uno o più nodi figlio, ma che non sia il nodo corrente.

corrente

Nodo che rappresenta la pagina attualmente visualizzata.

Aspetto del nodo

Ogni nodo visualizzato da un oggetto SiteMapPath è un controllo HyperLink o Literal a cui è possibile applicare un modello o uno stile. I modelli e gli stili vengono applicati ai nodi secondo due regole di precedenza:

  • Se per un nodo è definito un modello, questo esegue l'override di qualsiasi stile definito per lo stesso nodo.

  • I modelli e gli stili specifici dei tipi di nodi eseguono l'override dei modelli e degli stili generici definiti per tutti i nodi.

Le proprietà NodeStyle e NodeTemplate vengono applicate a tutti i nodi, indipendentemente dal tipo di nodo. Se vengono definite entrambe le proprietà, avrà la precedenza la proprietà NodeTemplate.

Le proprietà CurrentNodeTemplate e CurrentNodeStyle vengono applicate ai nodi che rappresentano la pagina attualmente visualizzata. Se oltre alla proprietà CurrentNodeTemplate viene definita una proprietà NodeTemplate, questa verrà ignorata. Se oltre alla proprietà CurrentNodeStyle viene definita una proprietà NodeStyle, questa verrà unita alla proprietà CurrentNodeStyle per creare uno stile unito. Tale stile unito utilizza tutti gli elementi della proprietà CurrentNodeStyle, oltre agli eventuali elementi aggiuntivi della proprietà NodeStyle non in conflitto con CurrentNodeStyle.

Le proprietà RootNodeTemplate e RootNodeStyle vengono applicate al nodo che rappresenta la radice della gerarchia di spostamento nel sito. Se oltre alla proprietà RootNodeTemplate viene definita una proprietà NodeTemplate, questa verrà ignorata. Se oltre alla proprietà RootNodeStyle viene definita una proprietà NodeStyle, questa verrà unita alla proprietà RootNodeStyle per creare uno stile unito. Tale stile unito utilizza tutti gli elementi della proprietà RootNodeStyle, oltre agli eventuali elementi aggiuntivi della proprietà NodeStyle non in conflitto con CurrentNodeStyle. Se infine la pagina attualmente visualizzata è la pagina radice del sito, verranno utilizzate le proprietà RootNodeTemplate e RootNodeStyle anziché la proprietà CurrentNodeTemplate o CurrentNodeStyle.

Il controllo SiteMapPath utilizza come origine dati per le informazioni di spostamento nel sito il provider della mappa del sito identificato dalla proprietà SiteMapProvider. Se non è specificato alcun provider, viene utilizzato il provider predefinito del sito, identificato nella proprietà SiteMap.Provider. Si tratta in genere di un'istanza del provider della mappa del sito predefinito di ASP.NET, ovvero XmlSiteMapProvider. Se all'interno di un sito viene utilizzato il controllo SiteMapPath, ma non è configurato alcun provider della mappa del sito, il controllo genera un'eccezione HttpException.

Eventi

Il controllo SiteMapPath fornisce inoltre eventi programmabili. In questo modo è possibile eseguire una routine personalizzata ogni volta che si verifica un evento. Nella tabella riportata di seguito sono elencati gli eventi supportati dal controllo SiteMapPath.

Evento

Oggetto di descrizione

ItemCreated

Si verifica quando il controllo SiteMapPath crea un oggetto SiteMapNodeItem e quindi lo associa a un oggetto SiteMapNode.

ItemDataBound

Si verifica quando un oggetto SiteMapNodeItem viene associato a dati della mappa del sito contenuti nell'oggetto SiteMapNode.

Personalizzazione del controllo SiteMapPath

Le classi che derivano da SiteMapPath eseguono l'override del metodo InitializeItem per personalizzare i controlli SiteMapNodeItem contenuti nel controllo di spostamento. Per esercitare un controllo completo sulle modalità di creazione e aggiunta degli oggetti SiteMapNodeItem all'oggetto SiteMapPath, le classi derivate eseguono l'override del metodo CreateControlHierarchy.

Accessibilità

Per informazioni sulla configurazione di questo controllo in modo che generi markup conformi agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e Controlli ASP.NET e accessibilità.

Sintassi dichiarativa

<asp:SiteMapPath
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    ParentLevelsDisplayed="integer"
    PathDirection="RootToCurrent|CurrentToRoot"
    PathSeparator="string"
    RenderCurrentNodeAsLink="True|False"
    runat="server"
    ShowToolTips="True|False"
    SiteMapProvider="string"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <CurrentNodeStyle />
        <CurrentNodeTemplate>
            <!-- child controls -->
        </CurrentNodeTemplate>
        <NodeStyle />
        <NodeTemplate>
            <!-- child controls -->
        </NodeTemplate>
        <PathSeparatorStyle />
        <PathSeparatorTemplate>
            <!-- child controls -->
        </PathSeparatorTemplate>
        <RootNodeStyle />
        <RootNodeTemplate>
            <!-- child controls -->
        </RootNodeTemplate>
</asp:SiteMapPath>
TopicLocation
Procedura dettagliata: aggiunta del sistema di esplorazione a un sito WebGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: aggiunta del sistema di esplorazione a un sito WebCompilazione di applicazioni con Visual Web Developer
Procedura: enumerare i nodi della mappa del sito a livello di codiceCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: configurare più mappe del sito e provider di mappa del sitoCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: filtrare i nodi recuperati dai controlli server Web SiteMapDataSourceCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: modificare a livello di codice i nodi della mappa del sito in memoriaCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: localizzare i dati della mappa del sitoCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: personalizzare l'aspetto dei controlli server Web SiteMapPathCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: visualizzare i dati della mappa del sito in controlli server Web non gerarchiciCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere l'esplorazione semplice di sitiCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: enumerare i nodi della mappa del sito a livello di codiceCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: configurare più mappe del sito e provider di mappa del sitoCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: filtrare i nodi recuperati dai controlli server Web SiteMapDataSourceCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: modificare a livello di codice i nodi della mappa del sito in memoriaCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: localizzare i dati della mappa del sitoCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: personalizzare l'aspetto dei controlli server Web SiteMapPathCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: visualizzare i dati della mappa del sito in controlli server Web non gerarchiciCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere l'esplorazione semplice di sitiCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: implementare i provider della mappa del sito ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: implementare i provider della mappa del sito ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: enumerare i nodi della mappa del sito a livello di codiceGenerazione di applicazioni Web ASP.NET
Procedura: filtrare i nodi recuperati dai controlli server Web SiteMapDataSourceGenerazione di applicazioni Web ASP.NET
Procedura: configurare più mappe del sito e provider di mappa del sitoGenerazione di applicazioni Web ASP.NET
Procedura: localizzare i dati della mappa del sitoGenerazione di applicazioni Web ASP.NET
Procedura: visualizzare i dati della mappa del sito in controlli server Web non gerarchiciGenerazione di applicazioni Web ASP.NET
Procedura: personalizzare l'aspetto dei controlli server Web SiteMapPathGenerazione di applicazioni Web ASP.NET
Procedura: aggiungere l'esplorazione semplice di sitiGenerazione di applicazioni Web ASP.NET
Procedura: implementare i provider della mappa del sito ASP.NETGenerazione di applicazioni Web ASP.NET
Procedura: modificare a livello di codice i nodi della mappa del sito in memoriaGenerazione di applicazioni Web ASP.NET

Nell'esempio di codice riportato di seguito viene utilizzato in modo dichiarativo un controllo SiteMapPath in una pagina Web Form. In questo esempio vengono illustrate alcune delle regole di precedenza che determinano l'ordine in cui i modelli e gli stili vengono applicati ai nodi SiteMapPath.


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 The NodeStyle and RootNodeStyle define the same attributes,
                 but are different and conflict with each other: the
                 RootNodeStyle supersedes NodeStyle, and is the style
                 rendered. Notice, however, that the underline style
                 defined by NodeStyle is still applied.

                 Both a CurrentNodeStyle and a CurrentNodeTemplate are
                 defined. A template supersedes a style for a node
                 type, so CurrentNodeTemplate is displayed and CurrentNodeStyle
                 is ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <CURRENTNODETEMPLATE>
                        <asp:Image id="Image1" runat="server" ImageUrl="WebForm2.jpg" AlternateText="WebForm2"/>
                </CURRENTNODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>


Nell'esempio precedente vengono utilizzati il provider della mappa del sito predefinito e un file Web.sitemap con la struttura riportata di seguito.

<siteMap>
  <siteMapNode title="WebForm1" description="WebForm1" url="WebForm1.aspx" >
    <siteMapNode title="WebForm2" description="WebForm2" url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

Nell'esempio di codice riportato di seguito viene illustrato come estendere il controllo SiteMapPath e aggiungervi una nuova funzionalità eseguendo l'override del metodo InitializeItem. Il controllo DropDownSiteMapPath aggiunge un oggetto DropDownList dopo il nodo corrente, in modo da facilitare lo spostamento su pagine che costituiscono i nodi figlio della pagina corrente. In questo esempio viene illustrato come utilizzare gli oggetti SiteMapNodeItem, incluso come controllare il relativo oggetto SiteMapNodeItemType e chiamare il metodo OnItemCreated dopo la creazione degli elementi.


using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;


// The DropDownNavigationPath is a class that extends the SiteMapPath
// control and renders a DropDownList after the CurrentNode. The
// DropDownList displays a list of pages found further down the site map
// hierarchy from the current one. Selecting an item in the DropDownList
// redirects to that page.
//
// For simplicity, the DropDownNavigationPath assumes the
// RootToCurrent PathDirection, and does not apply styles
// or templates the current node.
//
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class DropDownNavigationPath : SiteMapPath {
    // Override the InitializeItem method to add a PathSeparator
    // and DropDownList to the current node.
    protected override void InitializeItem(SiteMapNodeItem item) {

        // The only node that must be handled is the CurrentNode.
        if (item.ItemType == SiteMapNodeItemType.Current)
        {
            HyperLink hLink = new HyperLink();

            // No Theming for the HyperLink.
            hLink.EnableTheming = false;
            // Enable the link of the SiteMapPath is enabled.
            hLink.Enabled = this.Enabled;

            // Set the properties of the HyperLink to
            // match those of the corresponding SiteMapNode.
            hLink.NavigateUrl = item.SiteMapNode.Url;
            hLink.Text        = item.SiteMapNode.Title;
            if (ShowToolTips) {
                hLink.ToolTip = item.SiteMapNode.Description;
            }

            // Apply styles or templates to the HyperLink here.
            // ...
            // ...

            // Add the item to the Controls collection.
            item.Controls.Add(hLink);

            AddDropDownListAfterCurrentNode(item);
        }
        else {
            base.InitializeItem(item);
        }
    }
    private void AddDropDownListAfterCurrentNode(SiteMapNodeItem item) {

        SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

        // Only do this work if there are child nodes.
        if (childNodes != null) {

            // Add another PathSeparator after the CurrentNode.
            SiteMapNodeItem finalSeparator =
                new SiteMapNodeItem(item.ItemIndex,
                                    SiteMapNodeItemType.PathSeparator);

            SiteMapNodeItemEventArgs eventArgs =
                new SiteMapNodeItemEventArgs(finalSeparator);

            InitializeItem(finalSeparator);
            // Call OnItemCreated every time a SiteMapNodeItem is
            // created and initialized.
            OnItemCreated(eventArgs);

            // The pathSeparator does not bind to any SiteMapNode, so
            // do not call DataBind on the SiteMapNodeItem.
            item.Controls.Add(finalSeparator);

            // Create a DropDownList and populate it with the children of the
            // CurrentNode. There are no styles or templates that are applied
            // to the DropDownList control. If OnSelectedIndexChanged is raised,
            // the event handler redirects to the page selected.
            // The CurrentNode has child nodes.
            DropDownList ddList = new DropDownList();
            ddList.AutoPostBack = true;

            ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

            // Add a ListItem to the DropDownList for every node in the
            // SiteMapNodes collection.
            foreach (SiteMapNode node in childNodes) {
                ddList.Items.Add(new ListItem(node.Title, node.Url));
            }

            item.Controls.Add(ddList);
        }
    }

    // The sender is the DropDownList.
    private void DropDownNavPathEventHandler(object sender,EventArgs e) {
        DropDownList ddL = sender as DropDownList;

        // Redirect to the page the user chose.
        if (Context != null)
            Context.Response.Redirect(ddL.SelectedValue);
    }
}


.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Mostra: