SiteMapDataSource.SiteMapProvider Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает имя поставщика карты узла, к которому привязывается источник данных.
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
Значение свойства
Имя поставщика карты узла, к которому привязывается SiteMapDataSource. По умолчанию значение равно Empty, и используется поставщик карты узла по умолчанию.
Примеры
В следующем примере кода показано, как декларативно привязать TreeView элемент управления к данным карты сайта, предоставляемым объектом, отличающимся SiteMapProvider от поставщика по умолчанию. Файл Web.config делает настраиваемый SiteMapProvider объект доступным для 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>
Код для класса, SimpleTextSiteMapProvider
на который ссылается этот Web.config примеры файлов, можно найти в обзоре SiteMapProvider класса. Если вы используете пример Visual Basic, пространство имен заканчивается на "VB" вместо "CS". Пример содержимого для файла карты сайта "text.txt" также можно найти в обзоре SiteMapProvider класса.
Примечание
Не AsciiTextProvider
является поставщиком по умолчанию для сайта, который (в данном случае) остается XmlSiteMapProvider объектом . Свойству SiteMapProviderSiteMapDataSource элемента управления присваивается имя пользовательского поставщика карты сайта, а также выполняется привязка TreeView к соответствующим данным карты сайта.
<%@ 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>
Комментарии
Значение SiteMapProvider свойства хранится в состоянии представления.