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

name 초기화를 돕기 위해 추가 특성을 포함할 수 있는 NameValueCollection입니다. 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 .

추가 정보

• BuildSiteMap()
• Clear()