SiteMapDataSource.SiteMapProvider Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft den Namen des Siteübersichtsanbieters ab, an den die Datenquelle gebunden ist, oder legt diesen fest.

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

String

Der Name des Siteübersichtsanbieters, an den sich SiteMapDataSource bindet. Standardmäßig ist der Wert Empty, und es wird der Standard-Siteübersichtsanbieter für die Site verwendet.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein TreeView Steuerelement deklarativ an Siteübersichtsdaten gebunden wird, die von einem SiteMapProvider anderen Objekt als dem Standardanbieter bereitgestellt werden. Die Web.config-Datei stellt ein benutzerdefiniertes SiteMapProvider Objekt für das SiteMapDataSource Steuerelement zur Verfügung:

<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 Klasse, auf die SimpleTextSiteMapProvider dieses Web.config Beispieldatei verweist, finden Sie in der SiteMapProvider Klassenübersicht. Wenn Sie das Visual Basic-Beispiel verwenden, endet der Namespace in "VB" anstelle von "CS". Beispielinhalte für die Site map-Datei "text.txt" finden Sie auch in der SiteMapProvider Klassenübersicht.

Hinweis

Ist AsciiTextProvider nicht der Standardanbieter für die Website, die (in diesem Fall) das XmlSiteMapProvider -Objekt bleibt. Die SiteMapProvider -Eigenschaft des SiteMapDataSource Steuerelements wird auf den Namen eines benutzerdefinierten Siteübersichtsanbieters festgelegt, und der TreeView wird an die entsprechenden Siteübersichtsdaten gebunden.

<%@ 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 Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen