SiteMap.Provider Propriedade

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Obtém o objeto padrão SiteMapProvider para o mapa atual do local.

public:
 static property System::Web::SiteMapProvider ^ Provider { System::Web::SiteMapProvider ^ get(); };
public static System.Web.SiteMapProvider Provider { get; }
static member Provider : System.Web.SiteMapProvider
Public Shared ReadOnly Property Provider As SiteMapProvider

Valor de Propriedade

SiteMapProvider

O fornecedor padrão de mapas do sítio para o SiteMap.

Exceções

InvalidOperationException

A funcionalidade de mapa do local não está ativada.

ConfigurationErrorsException

O fornecedor padrão especificado na configuração não existe.

HttpException

A funcionalidade é suportada apenas quando está a correr em Baixa Confiança ou superior.

Exemplos

O exemplo de código seguinte demonstra como aceder ao objeto padrão SiteMapProvider do site usando a propriedade estática Provider .

<%@ 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("   ");
        Response.Write("<BR>");
    }
}
</SCRIPT>

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

<SCRIPT runat="server">
Private Sub Page_Load(Sender As Object, E As EventArgs)

    ' 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>")

    Dim sitemapnode As SiteMapNode
    For Each sitemapnode In SiteMap.RootNode.ChildNodes
        ' Iterate through the ChildNodes SiteMapNodesCollection
        ' maintained by the RootNode.
        Response.Write(sitemapnode.Url & "<BR>" )
    Next

    Dim providers As IDictionaryEnumerator = SiteMap.Providers.GetEnumerator()
    While (providers.MoveNext())
        Response.Write(providers.Current)
        Response.Write("   ")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

Observações

Por defeito, o XmlSiteMapProvider objeto é usado e os dados de navegação do site são carregados a partir do ficheiro Web.sitemap localizado na diretório raiz do site. Isto é identificado nas classes de gestão que gerem a configuração da navegação do local e a secção de configuração do mapa do sítio dos ficheiros Web.config. Por defeito, é uma instância da XmlSiteMapProvider classe, que utiliza o ficheiro Web.sitemap como seu armazenamento persistente. No entanto, pode implementar o seu próprio esquema de armazenamento e configuração de mapas do site escrevendo uma classe que implemente a classe abstrata SiteMapProvider . Para mais informações sobre como escrever o seu próprio fornecedor, consulte SiteMapProvider.

Aplica-se a

Ver também