XmlSiteMapProvider.Initialize(String, NameValueCollection) Metodo

Definizione

Inizializza l'oggetto XmlSiteMapProvider.Initializes the XmlSiteMapProvider object. Il metodo Initialize(String, NameValueCollection) non compila realmente una mappa del sito, prepara soltanto lo stato della classe XmlSiteMapProvider all'esecuzione di questa operazione.The Initialize(String, NameValueCollection) method does not actually build a site map, it only prepares the state of the XmlSiteMapProvider to do so.

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)

Parametri

name
String

Oggetto XmlSiteMapProvider da inizializzare.The XmlSiteMapProvider to initialize.

attributes
NameValueCollection

Classe NameValueCollection in grado di contenere attributi aggiuntivi per consentire l'inizializzazione del parametro name.A NameValueCollection that can contain additional attributes to help initialize name. Tali attributi vengono letti dalla configurazione della classe XmlSiteMapProvider nel file Web.config.These attributes are read from the XmlSiteMapProvider configuration in the Web.config file.

Eccezioni

La classe XmlSiteMapProvider viene inizializzata più volte.The XmlSiteMapProvider is initialized more than once.

La classe SiteMapNode utilizza un percorso fisico per fare riferimento a un file della mappa del sito.A SiteMapNode used a physical path to reference a site map file.

-oppure--or- Si è verificato un errore durante un tentativo di analisi del percorso virtuale fornito per l'attributo siteMapFile.An error occurred while attempting to parse the virtual path supplied for the siteMapFile attribute.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come creare una nuova istanza della classe XmlSiteMapProvider e inizializzarla per compilare una mappa del sito da dati XML.The following code example demonstrates how to create a new instance of the XmlSiteMapProvider class and initialize it to build a site map from XML data.

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

Nell'esempio di codice precedente viene usato un file XML che si trova nella radice virtuale dell'applicazione ASP.NET.The preceding code example uses an XML file that is located in the virtual root of the ASP.NET application. Il file ha il formato seguente:The file has the following format:

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

Commenti

La classe XmlSiteMapProvider esegue l'override del metodo Initialize ereditato per applicare diversi attributi, ad esempio gli attributi siteMapFile e description, alla raccolta di attributes.The XmlSiteMapProvider class overrides the inherited Initialize method to apply several attributes, such as the siteMapFile and description attributes, to the attributes collection.

Si applica a

Vedi anche