SiteMap.Providers 속성

정의

SiteMapProvider 클래스에 사용할 수 있는 명명된 SiteMap 개체의 읽기 전용 컬렉션을 가져옵니다.Gets a read-only collection of named SiteMapProvider objects that are available to the SiteMap class.

public:
 static property System::Web::SiteMapProviderCollection ^ Providers { System::Web::SiteMapProviderCollection ^ get(); };
public static System.Web.SiteMapProviderCollection Providers { get; }
member this.Providers : System.Web.SiteMapProviderCollection
Public Shared ReadOnly Property Providers As SiteMapProviderCollection

속성 값

SiteMapProviderCollection

명명된 SiteMapProviderCollection 개체의 SiteMapProvider입니다.A SiteMapProviderCollection of named SiteMapProvider objects.

예외

사이트 맵 기능이 사용되지 않는 경우The site map feature is not enabled.

구성에 기본 공급자가 지정되지 않은 경우The default provider specified in the configuration does not exist.

기능이 조금 신뢰 이상에서 실행될 때만 지원되는 경우The feature is supported only when running in Low trust or higher.

예제

다음 코드 예제를 검색 하는 방법에 설명 합니다 Providers 컬렉션에서는 SiteMap 클래스 및 다음 반복 합니다.The following code example demonstrates how to retrieve the Providers collection from the SiteMap class, and then iterate through it.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() + "<BR>");

    Response.Write(SiteMap.RootNode.Url + "<BR>");
    Response.Write(SiteMap.RootNode.Title + "<BR>");

    foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
    {
        // Iterate through the ChildNodes SiteMapNodesCollection
        // maintained by the RootNode.
        Response.Write(sitemapnode.Url + "<BR>" );
    }

    IEnumerator providers = SiteMap.Providers.GetEnumerator();
    while (providers.MoveNext())
    {
        Response.Write(providers.Current);
        Response.Write("&nbsp;&nbsp;&nbsp;");
        Response.Write("<BR>");
    }
}
</SCRIPT>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
Private Sub Page_Load(Sender As Object, E As EventArgs)

    ' Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() & "<BR>")

    Response.Write(SiteMap.RootNode.Url & "<BR>")
    Response.Write(SiteMap.RootNode.Title & "<BR>")

    Dim sitemapnode As SiteMapNode
    For Each sitemapnode In SiteMap.RootNode.ChildNodes
        ' Iterate through the ChildNodes SiteMapNodesCollection
        ' maintained by the RootNode.
        Response.Write(sitemapnode.Url & "<BR>" )
    Next

    Dim providers As IDictionaryEnumerator = SiteMap.Providers.GetEnumerator()
    While (providers.MoveNext())
        Response.Write(providers.Current)
        Response.Write("&nbsp;&nbsp;&nbsp;")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

이상의 사이트에 대해 구성 된 기본 공급자가 표시 하는 각 공급자를 표시 됩니다.If you have more than just the default provider configured for your site, you will see each provider displayed. 예를 들어, 샘플 Microsoft Access 공급자를 사용 하는 경우 (참조 StaticSiteMapProvider)에 다음 출력이 표시:For example, if you are using the sample Microsoft Access provider (see StaticSiteMapProvider), you see the following output:

XmlSiteMapProvider   System.Web.XmlSiteMapProvider  
AccessSiteMapProvider   Samples.AspNet.AccessSiteMapProvider  

설명

에 나열 된 사이트 맵 공급자를 Providers 초기화할 구성 계층 구조에 지정 된 컬렉션은는 SiteMap 클래스입니다.The site map providers that are listed in the Providers collection are those that are specified in the configuration hierarchy to initialize the SiteMap class. 기본 공급자만 (로 식별 되는 Provider 속성)에서 사용할 보장 되는 SiteMap 초기화 중에서 공급자의 현재 상태를 Providers 컬렉션 구성에 지정 된 된를 의미 초기화 하는 동안 사용할 수 있습니다.Only the default provider (identified by the Provider property) is guaranteed to be used by the SiteMap during initialization; the presence of a provider in the Providers collection means that it was specified in the configuration and was available during initialization.

적용 대상

추가 정보