SiteMapDataSource.SiteMapProvider Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę dostawcy mapy lokacji powiązanego ze źródłem 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
Nazwa dostawcy mapy lokacji, z którą SiteMapDataSource jest powiązana. Domyślnie wartość to Empty, a domyślny dostawca mapy lokacji dla lokacji 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 obiekt niestandardowy SiteMapProvider do kontrolki SiteMapDataSource
:
<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 SimpleTextSiteMapProvider
klasy, 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". Możesz również znaleźć przykładową zawartość pliku mapy witryny "text.txt" w przeglądzie SiteMapProvider klasy.
Uwaga
Nie AsciiTextProvider
jest domyślnym dostawcą lokacji, który (w tym przypadku) pozostaje obiektem XmlSiteMapProvider . Właściwość SiteMapProviderSiteMapDataSource kontrolki jest ustawiana na nazwę niestandardowego dostawcy mapy lokacji i TreeView wiąże się z odpowiednimi danymi mapy lokacji.
<%@ 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.