XmlSiteMapProvider.Initialize(String, NameValueCollection) Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Inicializa o objeto XmlSiteMapProvider. O Initialize(String, NameValueCollection) método não constrói propriamente um mapa do sítio, apenas prepara o estado do XmlSiteMapProvider local para o fazer.

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 para inicializar.

attributes
NameValueCollection

A NameValueCollection que pode conter atributos adicionais para ajudar a inicializar name. Estes atributos são lidos a partir da XmlSiteMapProvider configuração no ficheiro Web.config.

Exceções

InvalidOperationException

É XmlSiteMapProvider inicializado mais do que uma vez.

HttpException

A usava um caminho físico para referenciar SiteMapNode um ficheiro de mapa do sítio.

-ou-

Ocorreu um erro ao tentar analisar o caminho virtual fornecido para o siteMapFile atributo.

Exemplos

O exemplo de código seguinte demonstra como criar uma nova instância da XmlSiteMapProvider classe e inicializá-la para construir um mapa de site a partir de 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 utiliza um ficheiro XML localizado na raiz virtual da aplicação ASP.NET. O ficheiro 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>

Observações

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

Aplica-se a

Ver também