Questa documentazione è stata archiviata e non viene gestita.

Proprietà SiteMap.Providers

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene un insieme in sola lettura degli oggetti SiteMapProvider denominati disponibili alla classe SiteMap.

Spazio dei nomi: System.Web
Assembly: System.Web (in system.web.dll)

public static SiteMapProviderCollection Providers { get; }
/** @property */
public static SiteMapProviderCollection get_Providers ()

public static function get Providers () : SiteMapProviderCollection

Valore proprietà

Classe SiteMapProviderCollection di oggetti SiteMapProvider denominati.

Tipo di eccezioneCondizione

InvalidOperationException

La funzionalità relativa alla mappa del sito non è attivata.

ConfigurationErrorsException

Il provider predefinito specificato nella configurazione non esiste.

HttpException

La funzionalità è supportata solo quando in esecuzione in modalità di Attendibilità bassa o di livello superiore.

I provider della mappa del sito elencati nell'insieme Providers sono quelli specificati nella gerarchia di configurazione per l'inizializzazione della classe SiteMap. Solo il provider predefinito (identificato dalla proprietà Provider) verrà utilizzato dalla classe SiteMap durante l'inizializzazione; la presenza di un provider nell'insieme Providers indica che è stato specificato nella configurazione ed è stato reso disponibile durante l'inizializzazione.

Nell'esempio di codice riportato di seguito viene illustrato come recuperare l'insieme Providers dalla classe SiteMap e scorrerlo.

<%@ 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">
private void Page_Load(object sender, System.EventArgs e)
{
    // Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() + "<BR>");

    Response.Write(SiteMap.RootNode.Url + "<BR>");
    Response.Write(SiteMap.RootNode.Title + "<BR>");

    foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
    {
        // Iterate through the ChildNodes SiteMapNodesCollection
        // maintained by the RootNode.
        Response.Write(sitemapnode.Url + "<BR>" );
    }

    IEnumerator providers = SiteMap.Providers.GetEnumerator();
    while (providers.MoveNext())
    {
        Response.Write(providers.Current);
        Response.Write("&nbsp;&nbsp;&nbsp;");
        Response.Write("<BR>");
    }
}
</SCRIPT>

Se per il sito sono stati configurati altri provider oltre a quello predefinito, verranno visualizzati tutti. Se si utilizza il provider Microsoft Access di esempio (vedere la classe StaticSiteMapProvider), verrà visualizzato il seguente output:

XmlSiteMapProvider   System.Web.XmlSiteMapProvider
AccessSiteMapProvider   Samples.AspNet.AccessSiteMapProvider

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supportato in: 2.0
Mostra: