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 dem Steuerelement ein benutzerdefiniertes SiteMapProviderSiteMapDataSource Objekt 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 Web.config Dateibeispiel verweist, finden Sie in der SiteMapProvider Klassenübersicht. Wenn Sie das Visual Basic-Beispiel verwenden, endet der Namespace in "VB" anstelle von "CS". In der Klassenübersicht finden Sie auch Beispielinhalte für die SiteMapProvider text.txt-Siteübersicht.

Hinweis

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

<%@ 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