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

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.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 da StaticSiteMapProvider e è il provider della mappa del sito predefinito per ASP.NET, utilizza la Url proprietà di un SiteMapNode 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à di SiteMapNode è 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 in base alla relativa Url .The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. In caso contrario, è possibile usare la Key proprietà e il FindSiteMapNodeFromKey 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 Key si specifica o, il provider della mappa del sito genera automaticamente una Key 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'override del FindSiteMapNode(String) metodo in una classe derivata, assicurarsi di normalizzare gli URL degli SiteMapNode oggetti aggiunti al provider della mappa 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 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 è incluso nelle SiteMapProvider StaticSiteMapProvider 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, è necessario impostare la Roles proprietà di tutti SiteMapNode gli oggetti creati durante la compilazione di un provider della mappa del sito quando si esegue l'override del BuildSiteMap() 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