Partager via

Syntaxe déclarative des contrôles serveur Web SiteMapDataSource

  • Article

Mise à jour : novembre 2007

Fournit un contrôle de source de données que les contrôles serveur Web et d'autres contrôles peuvent utiliser pour se lier aux données de plan de site hiérarchiques.

<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"
/>

Notes

Le contrôle SiteMapDataSource est une source de données pour les données de plan de site stockées par les fournisseurs de plan de site configurés pour votre site. SiteMapDataSource active les contrôles serveur Web qui ne sont pas spécifiquement des contrôles de navigation de site, tels que les contrôles TreeView, Menu et DropDownList, à lier aux données de plan de site hiérarchiques. Vous pouvez utiliser ces contrôles serveur Web pour afficher un plan de site sous forme de table des matières ou parcourir activement un site. Une autre possibilité consiste à utiliser le contrôle SiteMapPath, qui est conçu spécifiquement comme un contrôle de navigation de site, et qui, par conséquent, n'a pas besoin d'une instance du contrôle SiteMapDataSource.

Pour plus d'informations sur le contrôle SiteMapDataSource et les contrôles de navigation, consultez Contrôles de boîte à outils de navigation.

Exemple

L'exemple de code suivant montre comment lier de façon déclarative un contrôle TreeView à un plan de site à l'aide d'un contrôle SiteMapDataSource. Les données de plan de site sont récupérées en commençant au niveau du nœud racine.

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

Voir aussi

Référence

SiteMapDataSource

Autres ressources

Contrôles de boîte à outils de navigation