SiteMapDataSource.SiteMapProvider Свойство

Определение

Возвращает или задает имя поставщика карты узла, к которому привязывается источник данных.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

Значение свойства

String

Имя поставщика карты узла, к которому привязывается SiteMapDataSource.The name of the site map provider that the SiteMapDataSource binds to. По умолчанию значение равно Empty, и используется поставщик карты узла по умолчанию.By default, the value is Empty, and the default site map provider for the site is used.

Примеры

В следующем примере кода показано, как декларативно привязать TreeView элемент управления к данным карт узла, предоставляемым объектом, отличным SiteMapProvider от поставщика по умолчанию.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. Файл Web.config делает пользовательский SiteMapProvider объект доступным для SiteMapDataSource элемента управления: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>  

Код SimpleTextSiteMapProvider класса, на который ссылаются примеры файлов Web.config, можно найти в SiteMapProvider обзоре класса.The code for the SimpleTextSiteMapProvider class that this Web.config file example references can be found in the SiteMapProvider class overview. Если вы используете Visual Basic пример, пространство имен заканчивается на "VB" вместо "CS".If you use the Visual Basic example, the namespace ends in "VB" instead of "CS". Пример содержимого для файла схемы узла "text.txt" можно найти в SiteMapProvider обзоре класса.You can also find sample content for the "text.txt" site map file in the SiteMapProvider class overview.

Примечание

AsciiTextProviderНе является поставщиком по умолчанию для сайта, который (в данном случае) остается XmlSiteMapProvider объектом.The AsciiTextProvider is not the default provider for the site, which (in this case) remains the XmlSiteMapProvider object. SiteMapProviderСвойству SiteMapDataSource элемента управления присваивается имя пользовательского поставщика карт узла, а TreeView привязывается к соответствующим данным схемы узла.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>

Комментарии

Значение SiteMapProvider свойства хранится в состоянии представления.The value of the SiteMapProvider property is stored in view state.

Применяется к

См. также раздел