StaticSiteMapProvider.FindSiteMapNode(String) Metodo

Definizione

Recupera un oggetto SiteMapNode che rappresenta la pagina nell'URL specificato.Retrieves a SiteMapNode object that represents the page at the specified URL.

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.A URL that identifies the page for which to retrieve a SiteMapNode.

Restituisce

Classe SiteMapNode che rappresenta la pagina identificata da rawURL; in caso contrario, null, se non viene trovato alcun nodo della mappa del sito corrispondente.A SiteMapNode that represents the page identified by rawURL; otherwise, null, if no corresponding site map node is found.

Eccezioni

rawURL è null.rawURL is null.

Commenti

L'URL specificato è in genere un URL virtuale o assoluto.The provided URL is typically a virtual or absolute URL. Può anche essere un URL che usa la sintassi relativa all'applicazione ASP.NET, ad esempio "~/apprelativedirectory".It can also be a URL that uses ASP.NET application-relative syntax, such as "~/apprelativedirectory". La StaticSiteMapProvider classe normalizza automaticamente gli URL non elaborati relativi all'applicazione in un percorso virtuale assoluto.The StaticSiteMapProvider class automatically normalizes application-relative raw URLs to an absolute virtual path.

Per XmlSiteMapProvider impostazione predefinita, l'oggetto, derivato StaticSiteMapProvider da e è il provider della mappa del sito predefinito per ASP.NET Url , utilizza la SiteMapNode proprietà di un oggetto come chiave di ricerca nelle raccolte interne.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Se la Url proprietà SiteMapNode di è impostata, deve essere univoca nell'ambito del provider della mappa del sito.If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. Il FindSiteMapNode metodo tenta di recuperare i nodi della mappa del sito Urlin base alla relativa.The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. In caso contrario, è possibile Key usare la proprietà e FindSiteMapNodeFromKey il metodo corrispondente per recuperare i nodi della mappa del sito.Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. Se non Url si Key specifica o, il provider della mappa del sito genera Key automaticamente una proprietà per tenere traccia dei nodi della mappa del sito.If no Url or Key is specified, the site map provider automatically generates a Key property to track the site map nodes.

Note per gli eredi

Quando si esegue l' FindSiteMapNode(String) override del metodo in una classe derivata, assicurarsi di normalizzare gli URL SiteMapNode degli oggetti aggiunti al provider della mappa del sito, in modo che il FindSiteMapNode(String) metodo possa recuperare un nodo della mappa del sito indipendentemente dall'URL per la mappa del sito il nodo viene specificato come percorso virtuale assoluto o percorso relativo dell'applicazione.When overriding the FindSiteMapNode(String) method in a derived class, be sure to normalize the URLs of the SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode(String) method can retrieve a site map node regardless of whether URL for the site map node is supplied as an absolute virtual path or an application relative path.

Il comportamento di taglio di sicurezza è SiteMapProvider incluso StaticSiteMapProvider nelle implementazioni delle classi e.Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. Tuttavia, per il funzionamento del taglio di sicurezza nelle classi derivate, Roles è necessario impostare SiteMapNode la proprietà di tutti gli oggetti creati durante la compilazione di un provider della BuildSiteMap() Mappa del sito quando si esegue l'override del metodo.However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap() method.

Si applica a

Vedi anche