SiteMapDataSource.SiteMapProvider Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.