SiteMapDataSource.SiteMapProvider Eigenschaft

Definition

Ruft den Namen des Siteübersichtsanbieters ab, an den die Datenquelle gebunden ist, oder legt diesen fest.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

Eigenschaftswert

Der Name des Siteübersichtsanbieters, an den sich SiteMapDataSource bindet.The name of the site map provider that the SiteMapDataSource binds to. Standardmäßig ist der Wert Empty, und es wird der Standard-Siteübersichtsanbieter für die Site verwendet.By default, the value is Empty, and the default site map provider for the site is used.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein TreeView-Steuerelement an Site Übersichts Daten, die von einem anderen SiteMapProvider-Objekt als dem Standardanbieter bereitgestellt werden, deklarativ gebunden wird.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. Die Datei Web. config stellt ein benutzerdefiniertes SiteMapProvider Objekt für das SiteMapDataSource-Steuerelement zur Verfügung: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>  

Der Code für die SimpleTextSiteMapProvider-Klasse, auf die diese Web. config-Datei verweist, finden Sie in der Übersicht über SiteMapProvider-Klasse.The code for the SimpleTextSiteMapProvider class that this Web.config file example references can be found in the SiteMapProvider class overview. Wenn Sie das Visual Basic Beispiel verwenden, endet der Namespace mit "vb" anstelle von "CS".If you use the Visual Basic example, the namespace ends in "VB" instead of "CS". Beispiel Inhalte für die Website Zuordnungs Datei "Text. txt" finden Sie in der Übersicht über die SiteMapProvider-Klasse.You can also find sample content for the "text.txt" site map file in the SiteMapProvider class overview.

Hinweis

Der-AsciiTextProvider ist nicht der Standardanbieter für die Site, der (in diesem Fall) das XmlSiteMapProvider-Objekt ist.The AsciiTextProvider is not the default provider for the site, which (in this case) remains the XmlSiteMapProvider object. Die SiteMapProvider-Eigenschaft des SiteMapDataSource-Steuer Elements wird auf den Namen eines benutzerdefinierten Site Übersichts Anbieters festgelegt, und die TreeView wird an die entsprechenden Site Übersichts Daten gebunden.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>

Hinweise

Der Wert der SiteMapProvider-Eigenschaft wird im Ansichts Zustand gespeichert.The value of the SiteMapProvider property is stored in view state.

Gilt für:

Siehe auch