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.Gets or sets the name of the site map provider that the data source binds to.

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

String

O nome do provedor de mapa do site ao qual o SiteMapDataSource se associa.The name of the site map provider that the SiteMapDataSource binds to. Por padrão, o valor é Empty e o provedor de mapa de site padrão para o site é usado.By default, the value is Empty, and the default site map provider for the site is used.

Exemplos

O exemplo de código a seguir demonstra como associar declarativamente um TreeView controle a dados de mapa do site que são fornecidos por um SiteMapProvider objeto diferente do provedor padrão.The following code example demonstrates how to declaratively bind a TreeView control to site map data that is provided by an SiteMapProvider object other than the default provider. O arquivo de Web.config torna um SiteMapProvider objeto personalizado disponível para o SiteMapDataSource controle:The Web.config file makes a custom SiteMapProvider object available to the SiteMapDataSource control:

<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 da SimpleTextSiteMapProvider classe ao qual este exemplo de arquivo Web.config referências pode ser encontrado na SiteMapProvider visão geral da classe.The code for the SimpleTextSiteMapProvider class that this Web.config file example references can be found in the SiteMapProvider class overview. Se você usar o exemplo de Visual Basic, o namespace terminará em "VB" em vez de "CS".If you use the Visual Basic example, the namespace ends in "VB" instead of "CS". Você também pode encontrar o conteúdo de exemplo para o arquivo de mapa do site "text.txt" na SiteMapProvider visão geral da classe.You can also find sample content for the "text.txt" site map file in the SiteMapProvider class overview.

Observação

O AsciiTextProvider não é o provedor padrão para o site, que (nesse caso) permanece o XmlSiteMapProvider objeto.The AsciiTextProvider is not the default provider for the site, which (in this case) remains the XmlSiteMapProvider object. A SiteMapProvider Propriedade do SiteMapDataSource controle é definida como o nome de um provedor de mapa do site personalizado e o é TreeView associado aos dados do mapa do site correspondente.The SiteMapProvider property of the SiteMapDataSource control is set to the name of a custom site map provider, and the TreeView binds to the corresponding site map data.

<%@ 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 em estado de exibição.The value of the SiteMapProvider property is stored in view state.

Aplica-se a

Confira também