Compartilhar via


SiteMapDataSource.SiteMapProvider Propriedade

Definição

Obtém ou define o nome do provedor de mapa do site ao qual a fonte de dados se associa.

public:
 virtual property System::String ^ SiteMapProvider { System::String ^ get(); void set(System::String ^ value); };
public virtual string SiteMapProvider { get; set; }
member this.SiteMapProvider : string with get, set
Public Overridable Property SiteMapProvider As String

Valor da propriedade

O nome do provedor de mapa do site ao qual o SiteMapDataSource se associa. Por padrão, o valor é Empty e o provedor de mapa de site padrão para o site é usado.

Exemplos

O exemplo de código a seguir demonstra como associar declarativamente um TreeView controle aos dados do mapa do site fornecidos por um SiteMapProvider objeto diferente do provedor padrão. O arquivo Web.config disponibiliza um objeto personalizado SiteMapProvider para o SiteMapDataSource controle:

<system.web>      
  <siteMap>  
    <providers>  
      <add name="AsciiTextProvider"  
        description="SiteMap provider which reads in .sitemap text files."  
        type="Samples.AspNet.CS.SimpleTextSiteMapProvider"  
      siteMapFile="test.txt"/>  
    </providers>  
  </siteMap>  
</system.web>  

O código para a SimpleTextSiteMapProvider classe que este Web.config referências de exemplo de arquivo pode ser encontrado na visão geral da SiteMapProvider classe. Se você usar o exemplo do Visual Basic, o namespace terminará em "VB" em vez de "CS". Você também pode encontrar conteúdo de exemplo para o arquivo de mapa do site "text.txt" na visão geral da SiteMapProvider classe.

Observação

O AsciiTextProvider não é o provedor padrão para o site, que (nesse caso) continua sendo o XmlSiteMapProvider objeto . A SiteMapProvider propriedade do SiteMapDataSource controle é definida como o nome de um provedor de mapa de site personalizado e as TreeView associações aos dados correspondentes do mapa do site.

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

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>

Comentários

O valor da SiteMapProvider propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também