XmlSiteMapProvider.Initialize(String, NameValueCollection) Méthode

Définition

Initialise l'objet XmlSiteMapProvider. La méthode Initialize(String, NameValueCollection) ne génère pas réellement de plan de site ; elle prépare seulement l'état de XmlSiteMapProvider à cette fin.

public override void Initialize (string name, System.Collections.Specialized.NameValueCollection attributes);

Paramètres

name
String

Objet XmlSiteMapProvider à initialiser.

attributes
NameValueCollection

NameValueCollection qui peut contenir des attributs supplémentaires contribuant à initialiser name. Ces attributs sont lus à partir de la configuration XmlSiteMapProvider dans le fichier Web.config.

Exceptions

Le XmlSiteMapProvider est initialisé plusieurs fois.

Un SiteMapNode a utilisé un chemin d'accès physique pour référencer un fichier de plan 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 classe et l’initialiser XmlSiteMapProvider pour créer un mappage 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 qui se trouve dans la racine virtuelle de l’application ASP.NET. Le format du fichier est le 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 siteMapFile attributs et description , à la attributes collection.

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi