XmlSiteMapProvider.Initialize(String, NameValueCollection) 方法

定义

命名空间:
System.Web
程序集:
System.Web.dll

初始化 XmlSiteMapProvider 对象。 该方法 Initialize(String, NameValueCollection) 实际上不会生成站点地图，它只会准备执行此操作的状态 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)

参数

name
String

要 XmlSiteMapProvider 初始化的。

attributes
NameValueCollection

一个 NameValueCollection 可以包含其他属性以帮助初始化 name的属性。 从 Web.config 文件中的配置读取 XmlSiteMapProvider 这些属性。

例外

InvalidOperationException

初始化 XmlSiteMapProvider 多次。

HttpException

使用 SiteMapNode 物理路径引用站点地图文件。

-或-

尝试分析为 siteMapFile 属性提供的虚拟路径时出错。

示例

下面的代码示例演示如何创建类的新实例 XmlSiteMapProvider 并将其初始化，以从 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>

前面的代码示例使用位于 ASP.NET 应用程序的虚拟根目录中的 XML 文件。 该文件具有以下格式：

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

注解

该 XmlSiteMapProvider 类重写继承 Initialize 的方法，以将多个属性（如 siteMapFile 和 description 属性）应用于 attributes 集合。

适用于

另请参阅