SiteMapDataSource.SiteMapProvider Propriedade

Definição

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

Obtém ou define o nome do fornecedor do mapa do local ao qual a fonte de dados se liga.

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 de Propriedade

String

O nome do fornecedor de mapas do sítio a que o SiteMapDataSource local se liga. Por defeito, o valor é Empty, e é utilizado o fornecedor de mapas do local por defeito para o local.

Exemplos

O exemplo de código seguinte demonstra como vincular declarativamente um TreeView controlo a dados do mapa do site fornecidos por um SiteMapProvider objeto diferente do fornecedor padrão. O ficheiro Web.config disponibiliza um objeto personalizado SiteMapProvider ao SiteMapDataSource controlo:

<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 que este ficheiro Web.config exemplo referencia pode ser encontrado na SiteMapProvider visão geral da classe. Se usares o exemplo do Visual Basic, o espaço de nomes termina em "VB" em vez de "CS". Também pode encontrar conteúdo de exemplo para o ficheiro de mapa do site "text.txt" na SiteMapProvider visão geral da classe.

Note

O AsciiTextProvider não é o fornecedor padrão do site, que (neste caso) permanece como XmlSiteMapProvider o objeto. A SiteMapProvider propriedade do SiteMapDataSource controlo é definida para o nome de um fornecedor de mapas personalizados do local, e liga-se TreeView aos dados correspondentes do mapa do local.

<%@ 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>

Observações

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

Aplica-se a

Ver também