XmlSiteMapProvider.Initialize(String, NameValueCollection) Méthode

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Initialise l'objet XmlSiteMapProvider. La Initialize(String, NameValueCollection) méthode ne crée pas réellement de carte de site, elle prépare uniquement l’état de la carte XmlSiteMapProvider .

public:
 override void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ attributes);
public override void Initialize(string name, System.Collections.Specialized.NameValueCollection attributes);
override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit
Public Overrides Sub Initialize (name As String, attributes As NameValueCollection)

Paramètres

name
String

À XmlSiteMapProvider initialiser.

attributes
NameValueCollection

Qui NameValueCollection peut contenir des attributs supplémentaires pour faciliter l’initialisation name. Ces attributs sont lus à partir de la XmlSiteMapProvider configuration dans le fichier Web.config.

Exceptions

InvalidOperationException

Il XmlSiteMapProvider est initialisé plusieurs fois.

HttpException

Chemin SiteMapNode d’accès physique utilisé pour référencer un fichier de carte de site.

- ou -

Une erreur s’est produite lors de la tentative d’analyse du chemin d’accès virtuel fourni pour l’attribut siteMapFile .

Exemples

L’exemple de code suivant montre comment créer une instance de la XmlSiteMapProvider classe et l’initialiser pour générer une carte de site à partir de données XML.

<%@ Page Language="c#" %>
<SCRIPT runat="server">
 private void Page_Load(object sender, System.EventArgs e) {
     // Create an instance of the XmlSiteMapProvider class.
     XmlSiteMapProvider testXmlProvider = new XmlSiteMapProvider();
     NameValueCollection providerAttributes = new NameValueCollection(1);
     providerAttributes.Add("siteMapFile","test.sitemap");

     // Initialize the provider with a provider name and file name.
     testXmlProvider.Initialize("testProvider", providerAttributes);

     // Call the BuildSiteMap to load the site map information into memory.
     testXmlProvider.BuildSiteMap();

     // Prints "/myvirtualdirectory/WebForm1.aspx"
     Response.Write(testXmlProvider.RootNode.Url + "<BR>");

     // Prints "/myvirtualdirectory/WebForm2.aspx"
     Response.Write(testXmlProvider.CurrentNode.Url + "<BR>");
 }
 </SCRIPT>

L’exemple de code précédent utilise un fichier XML situé à la racine virtuelle de l’application ASP.NET. Le fichier a le format suivant :

<siteMap>
  <siteMapNode title="RootNode" description="The root page." url="WebForm1.aspx">
    <siteMapNode title="CurrentNode" description="Some sub page." url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

Remarques

La XmlSiteMapProvider classe remplace la méthode héritée Initialize pour appliquer plusieurs attributs, tels que les attributs et siteMapFile les description attributs, à la attributes collection.

S’applique à

Voir aussi