Condividi tramite


StaticSiteMapProvider.FindSiteMapNode(String) Metodo

Definizione

Recupera un oggetto SiteMapNode che rappresenta la pagina nell'URL specificato.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode (string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parametri

rawUrl
String

URL che identifica la pagina per la quale recuperare un elemento SiteMapNode.

Restituisce

SiteMapNode

Classe SiteMapNode che rappresenta la pagina identificata da rawURL; in caso contrario, null, se non viene trovato alcun nodo della mappa del sito corrispondente.

Eccezioni

rawURL è null.

Commenti

L'URL fornito è in genere un URL virtuale o assoluto. Può anche essere un URL che usa ASP.NET sintassi relativa all'applicazione, ad esempio "~/apprelativedirectory". La StaticSiteMapProvider classe normalizza automaticamente gli URL non elaborati relativi all'applicazione in un percorso virtuale assoluto.

L'oggettoXmlSiteMapProvider, derivato dall'oggetto StaticSiteMapProvider ed è il provider predefinito della mappa del sito per ASP.NET, usa la Url proprietà di un SiteMapNode oggetto come chiave di ricerca nelle raccolte interne, per impostazione predefinita. Se la Url proprietà dell'oggetto SiteMapNode è impostata, deve essere univoca nell'ambito del provider di mappe del sito. Il FindSiteMapNode metodo tenta di recuperare i nodi della mappa del sito in base al relativo Url. In caso contrario, è possibile usare la proprietà e il Key metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito. Se non Url è specificato alcun valore o Key , il provider di mappe del sito genera automaticamente una Key proprietà per tenere traccia dei nodi della mappa del sito.

Note per gli eredi

Quando si esegue l'override del FindSiteMapNode(String) metodo in una classe derivata, assicurarsi di normalizzare gli URL degli SiteMapNode oggetti aggiunti al provider di mappe del sito, in modo che il FindSiteMapNode(String) metodo possa recuperare un nodo della mappa del sito indipendentemente dal fatto che l'URL per il nodo della mappa del sito venga fornito come percorso virtuale assoluto o un percorso relativo dell'applicazione.

Il comportamento di ritaglio della sicurezza è incluso nelle implementazioni e StaticSiteMapProvider della SiteMapProvider classe. Tuttavia, per il ridimensionamento della sicurezza in classi derivate, è necessario impostare la proprietà di tutti gli SiteMapNode oggetti creati durante la creazione di un provider di mappe del sito quando si esegue l'override Roles del BuildSiteMap() metodo.

Si applica a

Vedi anche