XmlSiteMapProvider.Initialize(String, NameValueCollection) Método

Referência

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa o objeto XmlSiteMapProvider. O método Initialize(String, NameValueCollection) não cria realmente um mapa do site, apenas prepara o estado do XmlSiteMapProvider para fazer isso.

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)

Parâmetros

name: String

O XmlSiteMapProvider a ser inicializado.

attributes: NameValueCollection

Um NameValueCollection que pode conter outros atributos para ajudar a inicializar o name. Esses atributos são lidos por meio da configuração XmlSiteMapProvider no arquivo Web.config.

Exceções

InvalidOperationException

O XmlSiteMapProvider é inicializado mais de uma vez.

HttpException

Um SiteMapNode usou um caminho físico para referenciar um arquivo de mapa do site.

- ou -

Erro ao tentar analisar o caminho virtual fornecido para o atributo siteMapFile.

Exemplos

O exemplo de código a seguir demonstra como criar uma nova instância da XmlSiteMapProvider classe e inicializá-la para criar um mapa de site com base em dados 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>

O exemplo de código anterior usa um arquivo XML localizado na raiz virtual do aplicativo ASP.NET. O arquivo tem o seguinte formato:

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

Comentários

A XmlSiteMapProvider classe substitui o método herdado Initialize para aplicar vários atributos, como os siteMapFile atributos e description , à attributes coleção.

Aplica-se a

Partilhar via