Exporter (0) Imprimer
Développer tout

XmlSiteMapProvider, classe

Mise à jour : novembre 2007

La classe XmlSiteMapProvider est dérivée de la classe SiteMapProvider et constitue le fournisseur de plan de site par défaut pour ASP.NET. La classe XmlSiteMapProvider génère des arborescences de plan de site à partir de fichiers XML ayant l'extension .sitemap.

Espace de noms :  System.Web
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class XmlSiteMapProvider : StaticSiteMapProvider, 
	IDisposable
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class XmlSiteMapProvider extends StaticSiteMapProvider implements IDisposable
public class XmlSiteMapProvider extends StaticSiteMapProvider implements IDisposable

La classe XmlSiteMapProvider charge les données de plan de site à partir d'un fichier XML qui respecte un schéma connu. Les données de plan de site sont liées par des balises <siteMap> et se composent de balises <siteMapNode> imbriquées. Les classes SiteMapProvider et XmlSiteMapProvider imposent deux contraintes sur la structure des données de plan de site :

  • Il ne peut exister qu'un seul nœud racine.

  • Pour les objets SiteMapNode qui spécifient des URL, ces dernières doivent être uniques dans la portée du fournisseur. (Pour les nœuds qui ne spécifient pas d'URL, toutes les clés doivent être uniques.)

L'exemple de code suivant illustre un exemple de fichier XML qui peut être utilisé avec le XmlSiteMapProvider.

<siteMap>
  <siteMapNode title="RootNode" description="This is the root node of the site map. There can be only one root node." url="Page1.aspx" >
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page2.aspx">
      <siteMapNode title="ChildOfChildNode" description="SiteMapNode objects can be nested to any level." url="Page3.aspx"/>
    </siteMapNode>
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page4.aspx"/>
  </siteMapNode>
</siteMap>

XmlSiteMapProvider, le fournisseur par défaut pour ASP.NET, lit les données XML à partir d'un fichier nommé Web.sitemap qui se trouve dans la structure de répertoire de l'application ASP.NET. Par défaut, le fichier Web.sitemap se trouve à la racine de l'application ; toutefois, si vous souhaitez modifier le nom ou l'emplacement du fichier à partir duquel XmlSiteMapProvider charge les données, vous pouvez substituer la configuration par défaut dans votre fichier Web.config. En substituant les paramètres de configuration par défaut dans votre fichier Web.config, vous pouvez adapter le comportement du XmlSiteMapProvider pour chaque application ASP.NET si nécessaire.

L'exemple de code suivant illustre un exemple de fichier Web.config, dans lequel XmlSiteMapProvider est encore utilisé, mais cette fois avec un fichier de plan de site différent. Tous les fournisseurs dans un objet SiteMapProviderCollection devant être nommés de manière unique, le fournisseur qui est spécifié dans le fichier Web.config utilise un nom différent du nom par défaut ; toutefois, étant donné qu'il est aussi défini comme fournisseur par défaut, il sera utilisé à la place du XmlSiteMapProvider qui est spécifié dans la configuration ASP.NET par défaut.

Remarque :

  Vous pouvez modifier le nom du fichier de données de navigation du site, mais vous ne pouvez pas modifier son extension. XmlSiteMapProvider lit seulement les données des fichiers qui sont nommés avec l'extension de nom de fichier .sitemap.

<siteMap defaultProvider="MyXmlSiteMapProvider" enabled="true">
  <providers>
    <add name="MyXmlSiteMapProvider"
      description="SiteMap provider that reads in .sitemap files."
      type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
      siteMapFile="CustomWeb.sitemap" />
  </providers>
</siteMap>
TopicLocation
Comment : implémenter des fournisseurs sitemap ASP.NETGénération d'applications Web ASP.NET
Comment : ajouter la navigation de site simpledv_vwdcon
Comment : implémenter des fournisseurs sitemap ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter la navigation de site simpleGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET dans Visual Studio
Comment : énumérer par programme des nœuds sitemapGénération d'applications Web ASP.NET dans Visual Studio
Comment : filtrer les nœuds récupérés par les contrôles serveur Web SiteMapDataSourceGénération d'applications Web ASP.NET dans Visual Studio
Comment : configurer plusieurs plans de sites et fournisseurs sitemapGénération d'applications Web ASP.NET dans Visual Studio
Comment : filtrer les nœuds récupérés par les contrôles serveur Web SiteMapDataSourceGénération d'applications Web ASP.NET
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET
Comment : ajouter la navigation de site simpleGénération d'applications Web ASP.NET
Comment : énumérer par programme des nœuds sitemapGénération d'applications Web ASP.NET
Comment : configurer plusieurs plans de sites et fournisseurs sitemapGénération d'applications Web ASP.NET

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft