SiteMapDataSource Web サーバー コントロールの宣言構文
更新 : 2007 年 11 月
Web サーバー コントロールおよびその他のコントロールが、階層構造のサイト マップ データにバインドするために使用できるデータ ソース コントロールを提供します。
<asp:SiteMapDataSource
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
ShowStartingNode="True|False"
SiteMapProvider="string"
SkinID="string"
StartFromCurrentNode="True|False"
StartingNodeOffset="integer"
StartingNodeUrl="uri"
Visible="True|False"
/>
解説
SiteMapDataSource コントロールは、サイトに構成されたサイト マップ プロバイダが格納するサイト マップ データのデータ ソースです。SiteMapDataSource を使用すると、サイト ナビゲーション コントロールでない Web サーバー コントロール (TreeView、Menu、DropDownList など) を、階層構造のサイト マップ データにバインドできます。これらの Web サーバー コントロールを使用して、サイト マップを目次として表示したり、サイト内をアクティブに移動したりできます。別の方法として、サイト ナビゲーション コントロールとして専用にデザインされた SiteMapPath コントロールを使用する方法もあります。この場合、SiteMapDataSource コントロールのインスタンスは必要ありません。
SiteMapDataSource コントロールおよびナビゲーション コントロールの詳細については、「ナビゲーション ツールボックス コントロール」を参照してください。
使用例
SiteMapDataSource コントロールを使用して、TreeView コントロールをサイト マップに宣言的にバインドする方法を次のコード例に示します。サイト マップ データの取得は、ルート ノード レベルから開始されます。
<%@ 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" />
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</form>
</body>
</html>
<%@ 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" />
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VJ#" %>
<!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">
</asp:SiteMapDataSource>
<asp:TreeView
id="TreeView1"
runat="server"
DataSourceID="SiteMapDataSource1">
</asp:TreeView>
</form>
</body>
</html>