SiteMapDataSource.SiteMapProvider Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia nazwę dostawcy mapy lokacji, z którą powiązane jest źródło danych.

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

Wartość właściwości

String

Nazwa dostawcy mapy witryny, z którą SiteMapDataSource jest powiązana. Domyślnie wartość to Empty, a domyślny dostawca mapy lokacji dla witryny jest używany.

Przykłady

W poniższym przykładzie kodu pokazano, jak deklaratywnie powiązać kontrolkę TreeView z danymi mapy lokacji udostępnianymi przez SiteMapProvider obiekt inny niż domyślny dostawca. Plik Web.config udostępnia kontrolki SiteMapDataSource obiekt niestandardowySiteMapProvider:

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

Kod klasy SimpleTextSiteMapProvider , do którego odwołuje się ten przykładowy plik Web.config, można znaleźć w przeglądzie SiteMapProvider klasy. Jeśli używasz przykładu języka Visual Basic, przestrzeń nazw kończy się na "VB" zamiast "CS". Przykładową zawartość pliku mapy witryny "text.txt" można również znaleźć w przeglądzie SiteMapProvider klasy.

Uwaga

Nie AsciiTextProvider jest domyślnym dostawcą lokacji, który (w tym przypadku) pozostaje obiektem XmlSiteMapProvider . Właściwość SiteMapProvider kontrolki SiteMapDataSource jest ustawiana na nazwę niestandardowego dostawcy mapy lokacji i TreeView wiąże się z odpowiednimi danymi mapy witryny.

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

Uwagi

Wartość SiteMapProvider właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też