SiteMapProvider

.NET Framework クラス ライブラリ リファレンス

SiteMap.Provider プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のサイト マップの既定の SiteMapProvider オブジェクトを取得します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 Provider As SiteMapProvider

Visual Basic (使用法)

Dim value As SiteMapProvider

value = SiteMap.Provider

C#

public static SiteMapProvider Provider { get;
 }

C++

public:
static property SiteMapProvider^ Provider {
    SiteMapProvider^ get ();
}

J#

/** @property */
public static SiteMapProvider get_Provider
 ()

JScript

public static function get
 Provider () : SiteMapProvider

プロパティ値
SiteMap の既定のサイト マップ プロバイダ。

例外

例外の種類	条件
InvalidOperationException	このサイト マップ機能は無効になっています。
ConfigurationErrorsException	構成に指定されている既定のプロバイダが存在しません。
HttpException	この機能は、信頼性が低以上の場合にのみサポートされます。

解説

既定では、XmlSiteMapProvider オブジェクトが使用され、サイトのルート ディレクトリにある Web.sitemap ファイルからサイト ナビゲーション データが読み込まれます。これは、サイト ナビゲーション構成を管理する管理クラスと Web.config ファイルのサイト マップ構成セクションで指定されます。既定では、これは XmlSiteMapProvider クラスのインスタンスで、Web.sitemap ファイルを永続記憶領域として使用します。ただし、SiteMapProvider 抽象クラスを実装するクラスを記述することにより、独自のサイト マップ ストレージと構成スキームを実装できます。独自のプロバイダの記述の詳細については、「SiteMapProvider」を参照してください。

使用例

サイトの既定の SiteMapProvider オブジェクトに静的プロパティ Provider を使用してアクセスする方法のコード例を次に示します。

Visual Basic

<%@ 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>

C#

<%@ 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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SiteMap クラス
SiteMap メンバ
System.Web 名前空間
Providers
SiteMapProvider
StaticSiteMapProvider

SiteMapProvider イベント

パブリック イベント

	名前	説明
	SiteMapResolve	CurrentNode プロパティが呼び出されると発生します。

参照

関連項目

SiteMapProvider クラス
System.Web 名前空間
SiteMapProvider クラス
XmlSiteMapProvider

その他の技術情報

ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ
ASP.NET サイト ナビゲーション プロバイダ
ASP.NET のサイト ナビゲーションの保護
アセンブリとグローバル アセンブリ キャッシュの使用

SiteMapProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

すべてのサイト マップ データ プロバイダに共通基本クラスを提供します。また、SiteMap オブジェクトの永続記憶領域として ASP.NET サイト マップ インフラストラクチャと組み合わせて使用できるカスタム サイト マップ データ プロバイダを実装する手段を提供します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustInherit Class
 SiteMapProvider
    Inherits ProviderBase

Visual Basic (使用法)

Dim instance As SiteMapProvider

C#

public abstract class SiteMapProvider : ProviderBase

C++

public ref class SiteMapProvider abstract :
 public ProviderBase

J#

public abstract class SiteMapProvider extends
 ProviderBase

JScript

public abstract class SiteMapProvider extends
 ProviderBase

解説

StaticSiteMapProvider クラスと XmlSiteMapProvider クラスは、SiteMapProvider 抽象クラスの既定の実装を表します。XmlSiteMapProvider では、Web.sitemap という名前の XML ファイルを使用してサイト マップ データを保存します。Web.sitemap ファイルの詳細については、「ASP.NET サイト マップ」を参照してください。

SiteMapProvider クラスは、RootProvider プロパティと ParentProvider プロパティを宣言することで、サイト マップ プロバイダ階層の概念をサポートします。SiteMapProvider は、他のプロバイダの親にも子にもなれます。これにより、サイトのさまざまなコンテンツ領域が、独自のサイト マップおよびサイト マップ プロバイダを管理する別の開発グループによって所有または実装される、というシナリオを実現できます。

SiteMapProvider オブジェクトはすべて Web.config ファイルで構成されます。この構成ファイルに宣言されているサイト マップ プロバイダはすべて実行時に読み込まれ、サイト ナビゲーション データの読み込みと処理に使用されます。SiteMap オブジェクトは、その Providers プロパティ コレクションを使用して、使用可能なすべてのプロバイダを追跡します。このオブジェクトは、プロバイダが管理するナビゲーション データへのプログラムを使用したアクセスを実現します。Web.config ファイルでサイト マップ プロバイダの宣言に使用する形式のコード例を次に示します。

<siteMap defaultProvider="<name>">
  <providers>
    <add
      name="<friendly name>"
      type="<class name>, <fully-qualified type name>" 
      siteMapFile = "<file name>" />
  </providers>
</siteMap>

プロバイダによって読み込まれるサイト ナビゲーション データは、SiteMapPath コントロールおよび TreeView コントロールなど、サイト マップ インフラストラクチャの別のコンポーネントによって、ユーザーにサイト マップ情報を表示するために使用されます。

独自のサイト マップ プロバイダを実装する場合、ソース ファイルを ASP.NET アプリケーションの App_Code ディレクトリに配置すると、アセンブリは自動的にコンパイルされます。また、独自のサイト マップ プロバイダをグローバル アセンブリ キャッシュ (GAC: Global Assembly Cache) に配置して、そのプロバイダへの完全修飾参照を Web.config ファイルに指定することもできます。コンパイラ サービスの詳細については、「アセンブリとグローバル アセンブリ キャッシュの使用」を参照してください。

継承時の注意 SiteMapProvider クラスから継承する場合、GetRootNodeCore、FindSiteMapNode、GetChildNodes、GetParentNode の各メンバをオーバーライドする必要があります。

Topic	Location
方法 : ASP.NET のサイト マップ プロバイダを実装する	ASP .NET Web アプリケーションの作成
方法 : SiteMapDataSource Web サーバー コントロールによって取得されたノードをフィルタ処理する	ASP .NET Web アプリケーションの作成
方法 : サイトマップ ノードをコードによって列挙する	ASP .NET Web アプリケーションの作成
方法 : 簡単なサイト ナビゲーションを追加する	ASP .NET Web アプリケーションの作成
方法 : 複数のサイト マップとサイトマップ プロバイダを設定する	ASP .NET Web アプリケーションの作成
方法 : 非階層 Web Server コントロール内にサイト マップ データを表示する	ASP .NET Web アプリケーションの作成

使用例

SiteMapProvider 抽象クラスを実装するクラスを記述する方法を次のコード例に示します。この例では、サイト マップ情報の読み込みに必要な構造に準拠したコンマ区切りファイルを使用します。このファイルの先頭行はサイト マップのルート ノードを表し、後続の行はサブノードを表します。各サブノードの親ノードは URL で識別します。この条件を満たすファイルの例を次に示します。

default.aspx,Home,MyCompany Home Page,
sale.aspx,Now On Sale,Check Out These Great Deals!,default.aspx
catalog.aspx,Online Catalog,Browse Our Many Great Items!,default.aspx

SimpleTextSiteMapProvider は、SiteMapProvider のすべてのプロパティとメソッドの実装例です。

Visual Basic

Imports System
Imports System.Collections
Imports System.Collections.Specialized
Imports System.Configuration.Provider
Imports System.IO
Imports System.Security.Permissions
Imports System.Web

Namespace Samples.AspNet.VB

  <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)>
 _
  Public Class SimpleTextSiteMapProvider
    Inherits SiteMapProvider

    Private parentSiteMapProvider As SiteMapProvider
 = Nothing
    Private simpleTextProviderName As String
 = Nothing
    Private sourceFilename As String
 = Nothing
    Private aRootNode As SiteMapNode = Nothing
    Private siteMapNodes As ArrayList = Nothing
    Private childParentRelationship As ArrayList
 = Nothing

    ' A default constructor. The Name property is initialized in the
    ' Initialize method.
    Public Sub New()
    End Sub 'New

    ' Implement the CurrentNode property.
    Public Overrides ReadOnly
 Property CurrentNode() As SiteMapNode
      Get
        Dim currentUrl As String
 = FindCurrentUrl()
        ' Find the SiteMapNode that represents the current page.
        Dim aCurrentNode As SiteMapNode = FindSiteMapNode(currentUrl)
        Return aCurrentNode
      End Get
    End Property

    ' Implement the RootNode property.
    Public Overrides ReadOnly
 Property RootNode() As SiteMapNode
      Get
        Return aRootNode
      End Get
    End Property

    ' Implement the ParentProvider property.
    Public Overrides Property
 ParentProvider() As SiteMapProvider
      Get
        Return parentSiteMapProvider
      End Get
      Set(ByVal value As
 SiteMapProvider)
        parentSiteMapProvider = Value
      End Set
    End Property

    ' Implement the RootProvider property.
    Public Overrides ReadOnly
 Property RootProvider() As SiteMapProvider
      Get
        ' If the current instance belongs to a provider hierarchy, it
        ' cannot be the RootProvider. Rely on the ParentProvider.
        If Not (Me.ParentProvider
 Is Nothing) Then
          Return ParentProvider.RootProvider
          ' If the current instance does not have a ParentProvider,
 it is
          ' not a child in a hierarchy, and can be the RootProvider.
        Else
          Return Me
        End If
      End Get
    End Property

    ' Implement the FindSiteMapNode method.
    Public Overrides Function
 FindSiteMapNode(ByVal rawUrl As String)
 As SiteMapNode
      ' Does the root node match the URL?
      If RootNode.Url = rawUrl Then
        Return RootNode
      Else
        Dim candidate As SiteMapNode = Nothing
        ' Retrieve the SiteMapNode that matches the URL.
        SyncLock Me
          candidate = GetNode(siteMapNodes, rawUrl)
        End SyncLock
        Return candidate
      End If
    End Function 'FindSiteMapNode

    ' Implement the GetChildNodes method.
    Public Overrides Function
 GetChildNodes(ByVal node As SiteMapNode)
 As SiteMapNodeCollection
      Dim children As New
 SiteMapNodeCollection()
      ' Iterate through the ArrayList and find all nodes that have the
 specified node as a parent.
      SyncLock Me
        Dim i As Integer
        For i = 0 To childParentRelationship.Count
 - 1

          Dim de As DictionaryEntry = CType(childParentRelationship(i),
 DictionaryEntry)
          Dim nodeUrl As String
 = CType(de.Key, String)

          Dim parent As SiteMapNode = GetNode(childParentRelationship,
 nodeUrl)

          If Not (parent Is
 Nothing) AndAlso node.Url = parent.Url Then
            ' The SiteMapNode with the Url that corresponds to nodeUrl
            ' is a child of the specified node. Get the SiteMapNode
 for
            ' the nodeUrl.
            Dim child As SiteMapNode = FindSiteMapNode(nodeUrl)
            If Not (child Is
 Nothing) Then
              children.Add(CType(child, SiteMapNode))
            Else
              Throw New Exception("ArrayLists
 not in sync.")
            End If
          End If
        Next i
      End SyncLock
      Return children
    End Function 'GetChildNodes

    Protected Overrides Function
 GetRootNodeCore() As SiteMapNode
      Return RootNode
    End Function ' GetRootNodeCore()

    ' Implement the GetParentNode method.
    Public Overrides Function
 GetParentNode(ByVal node As SiteMapNode)
 As SiteMapNode
      ' Check the childParentRelationship table and find the parent
 of the current node.
      ' If there is no parent, the current node is the RootNode.
      Dim parent As SiteMapNode = Nothing
      SyncLock Me
        ' Get the Value of the node in childParentRelationship
        parent = GetNode(childParentRelationship, node.Url)
      End SyncLock
      Return parent
    End Function 'GetParentNode

    ' Implement the ProviderBase.Initialize method.
    ' Initialize is used to initialize the state that the Provider holds,
 but
    ' not actually build the site map.
    Public Overrides Sub
 Initialize(ByVal name As String,
 ByVal attributes As NameValueCollection)
      SyncLock Me
        MyBase.Initialize(name, attributes)
        simpleTextProviderName = name
        sourceFilename = attributes("siteMapFile")
        siteMapNodes = New ArrayList()
        childParentRelationship = New ArrayList()
        ' Build the site map in memory.
        LoadSiteMapFromStore()
      End SyncLock
    End Sub 'Initialize

    ' Private helper methods
    Private Function GetNode(ByVal
 list As ArrayList, ByVal url As
 String) As SiteMapNode
      Dim i As Integer
      For i = 0 To list.Count - 1
        Dim item As DictionaryEntry = CType(list(i),
 DictionaryEntry)
        If CStr(item.Key) = url Then
          Return CType(item.Value, SiteMapNode)
        End If
      Next i
      Return Nothing
    End Function 'GetNode


    ' Get the URL of the currently displayed page.
    Private Function FindCurrentUrl() As
 String
      Try
        ' The current HttpContext.
        Dim currentContext As HttpContext =
 HttpContext.Current
        If Not (currentContext Is
 Nothing) Then
          Return currentContext.Request.RawUrl
        Else
          Throw New Exception("HttpContext.Current
 is Invalid")
        End If
      Catch e As Exception
        Throw New NotSupportedException("This
 provider requires a valid context.", e)
      End Try
    End Function 'FindCurrentUrl

    Protected Overridable Sub
 LoadSiteMapFromStore()
      Dim pathToOpen As String
      SyncLock Me
        ' If a root node exists, LoadSiteMapFromStore has already
        ' been called, and the method can return.
        If Not (aRootNode Is
 Nothing) Then
          Return
        Else
          pathToOpen = HttpContext.Current.Server.MapPath("~"
 & "\\" & sourceFilename)
          If File.Exists(pathToOpen) Then
            ' Open the file to read from.
            Dim sr As StreamReader = File.OpenText(pathToOpen)
            Try

              ' Clear the state of the collections and aRootNode
              aRootNode = Nothing
              siteMapNodes.Clear()
              childParentRelationship.Clear()

              ' Parse the file and build the site map
              Dim s As String
 = ""
              Dim nodeValues As String()
 = Nothing
              Dim temp As SiteMapNode = Nothing

              Do
                s = sr.ReadLine()

                If Not s Is
 Nothing Then
                  ' Build the various SiteMapNode objects and add
                  ' them to the ArrayList collections. The format used
                  ' is: URL,TITLE,DESCRIPTION,PARENTURL
                  nodeValues = s.Split(","c)

                  temp = New SiteMapNode(Me,
 _
                      HttpRuntime.AppDomainAppVirtualPath & "/"
 & nodeValues(0), _
                      HttpRuntime.AppDomainAppVirtualPath & "/"
 & nodeValues(0), _
                      nodeValues(1), _
                      nodeValues(2))

                  ' Is this a root node yet?
                  If aRootNode Is Nothing
 AndAlso _
                    (nodeValues(3) Is Nothing
 OrElse _
                     nodeValues(3) = String.Empty) Then
                    aRootNode = temp

                    ' If not the root node, add the node to the various
 collections.
                  Else

                    siteMapNodes.Add(New DictionaryEntry(temp.Url,
 temp))

                    ' The parent node has already been added to the
 collection.
                    Dim parentNode As SiteMapNode
 = _
                        FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath &
 "/" & nodeValues(3))

                    If Not (parentNode Is
 Nothing) Then
                      childParentRelationship.Add(New DictionaryEntry(temp.Url,
 parentNode))
                    Else
                      Throw New Exception("Parent
 node not found for current node.")
                    End If
                  End If
                End If
              Loop Until s Is
 Nothing
            Finally
              sr.Close()
            End Try
          Else
            Throw New Exception("File
 not found")
          End If
        End If
      End SyncLock
      Return
    End Sub 'LoadSiteMapFromStore
  End Class 'SimpleTextSiteMapProvider
End Namespace

C#

using System;
using System.Configuration.Provider;
using System.Collections;
using System.Collections.Specialized;
using System.IO;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS
{

  [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
  public class SimpleTextSiteMapProvider :
 SiteMapProvider
  {
    private SiteMapProvider parentSiteMapProvider = null;
    private string simpleTextProviderName =
 null;
    private string sourceFilename = null;
    private SiteMapNode rootNode = null;
    private ArrayList siteMapNodes = null;
    private ArrayList childParentRelationship = null;


    // A default constructor. The Name property is initialized in the
    // Initialize method.
    public SimpleTextSiteMapProvider()
    {
    }
    // Implement the CurrentNode property.
    public override SiteMapNode CurrentNode
    {
      get
      {
        string currentUrl = FindCurrentUrl();
        // Find the SiteMapNode that represents the current page.
        SiteMapNode currentNode = FindSiteMapNode(currentUrl);
        return currentNode;
      }
    }

    // Implement the RootNode property.
    public override SiteMapNode RootNode
    {
      get
      {
        return rootNode;
      }
    }
    // Implement the ParentProvider property.
    public override SiteMapProvider ParentProvider
    {
      get
      {
        return parentSiteMapProvider;
      }
      set
      {
        parentSiteMapProvider = value;
      }
    }

    // Implement the RootProvider property.
    public override SiteMapProvider RootProvider
    {
      get
      {
        // If the current instance belongs to a provider hierarchy,
 it
        // cannot be the RootProvider. Rely on the ParentProvider.
        if (this.ParentProvider != null)
        {
          return ParentProvider.RootProvider;
        }
        // If the current instance does not have a ParentProvider, it
 is
        // not a child in a hierarchy, and can be the RootProvider.
        else
        {
          return this;
        }
      }
    }
    // Implement the FindSiteMapNode method.
    public override SiteMapNode FindSiteMapNode(string
 rawUrl)
    {

      // Does the root node match the URL?
      if (RootNode.Url == rawUrl)
      {
        return RootNode;
      }
      else
      {
        SiteMapNode candidate = null;
        // Retrieve the SiteMapNode that matches the URL.
        lock (this)
        {
          candidate = GetNode(siteMapNodes, rawUrl);
        }
        return candidate;
      }
    }
    // Implement the GetChildNodes method.
    public override SiteMapNodeCollection GetChildNodes(SiteMapNode
 node)
    {
      SiteMapNodeCollection children = new SiteMapNodeCollection();
      // Iterate through the ArrayList and find all nodes that have
 the specified node as a parent.
      lock (this)
      {
        for (int i = 0; i < childParentRelationship.Count;
 i++)
        {

          string nodeUrl = ((DictionaryEntry)childParentRelationship[i]).Key
 as string;

          SiteMapNode parent = GetNode(childParentRelationship, nodeUrl);

          if (parent != null && node.Url
 == parent.Url)
          {
            // The SiteMapNode with the Url that corresponds to nodeUrl
            // is a child of the specified node. Get the SiteMapNode
 for
            // the nodeUrl.
            SiteMapNode child = FindSiteMapNode(nodeUrl);
            if (child != null)
            {
              children.Add(child as SiteMapNode);
            }
            else
            {
              throw new Exception("ArrayLists not in
 sync.");
            }
          }
        }
      }
      return children;
    }
    protected override SiteMapNode GetRootNodeCore()
    {
      return RootNode;
    }
    // Implement the GetParentNode method.
    public override SiteMapNode GetParentNode(SiteMapNode node)
    {
      // Check the childParentRelationship table and find the parent
 of the current node.
      // If there is no parent, the current node is the RootNode.
      SiteMapNode parent = null;
      lock (this)
      {
        // Get the Value of the node in childParentRelationship
        parent = GetNode(childParentRelationship, node.Url);
      }
      return parent;
    }

    // Implement the ProviderBase.Initialize property.
    // Initialize is used to initialize the state that the Provider
 holds, but
    // not actually build the site map.
    public override void Initialize(string
 name, NameValueCollection attributes)
    {

      lock (this)
      {

        base.Initialize(name, attributes);

        simpleTextProviderName = name;
        sourceFilename = attributes["siteMapFile"];
        siteMapNodes = new ArrayList();
        childParentRelationship = new ArrayList();

        // Build the site map in memory.
        LoadSiteMapFromStore();
      }
    }
    // Private helper methods

    private SiteMapNode GetNode(ArrayList list, string
 url)
    {
      for (int i = 0; i < list.Count; i++)
      {
        DictionaryEntry item = (DictionaryEntry)list[i];
        if ((string)item.Key == url)
          return item.Value as SiteMapNode;
      }
      return null;
    }

    // Get the URL of the currently displayed page.
    private string FindCurrentUrl()
    {
      try
      {
        // The current HttpContext.
        HttpContext currentContext = HttpContext.Current;
        if (currentContext != null)
        {
          return currentContext.Request.RawUrl;
        }
        else
        {
          throw new Exception("HttpContext.Current is Invalid");
        }
      }
      catch (Exception e)
      {
        throw new NotSupportedException("This provider requires
 a valid context.",e);
      }
    }
    protected virtual void LoadSiteMapFromStore()
    {
      string pathToOpen;

      lock (this)
      {
        // If a root node exists, LoadSiteMapFromStore has already
        // been called, and the method can return.
        if (rootNode != null)
        {
          return;
        }
        else
        {
          pathToOpen = HttpContext.Current.Server.MapPath("~" + "\\"
 + sourceFilename);

          if (File.Exists(pathToOpen))
          {
            // Open the file to read from.
            using (StreamReader sr = File.OpenText(pathToOpen))
            {

              // Clear the state of the collections and rootNode
              rootNode = null;
              siteMapNodes.Clear();
              childParentRelationship.Clear();

              // Parse the file and build the site map
              string s = "";
              string[] nodeValues = null;
              SiteMapNode temp = null;

              while ((s = sr.ReadLine()) != null)
              {

                // Build the various SiteMapNode objects and add
                // them to the ArrayList collections. The format used
                // is: URL,TITLE,DESCRIPTION,PARENTURL

                nodeValues = s.Split(',');

                temp = new SiteMapNode(this
,
                    HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0]
,
                    HttpRuntime.AppDomainAppVirtualPath + "/" + nodeValues[0]
,
                    nodeValues[1],
                    nodeValues[2]);

                // Is this a root node yet?
                if (null == rootNode &&
                    (null == nodeValues[3] || nodeValues[3] ==
 String.Empty))
                {
                  rootNode = temp;
                }

              // If not the root node, add the node to the various collections.
                else
                {
                  siteMapNodes.Add(new DictionaryEntry(temp.Url,
 temp));
                  // The parent node has already been added to the collection.
                  SiteMapNode parentNode =
                           FindSiteMapNode(HttpRuntime.AppDomainAppVirtualPath +
 "/" + nodeValues[3]);
                  if (parentNode != null)
                  {
                    childParentRelationship.Add(new DictionaryEntry(temp.Url,
 parentNode));
                  }
                  else
                  {
                    throw new Exception("Parent node not
 found for current node.");
                  }
                }
              }
            }
          }
          else
          {
            throw new Exception("File not found");
          }
        }
      }
      return;
    }
  }

}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
    System.Web.SiteMapProvider
       System.Web.StaticSiteMapProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SiteMapProvider メンバ
System.Web 名前空間
SiteMapProvider クラス
XmlSiteMapProvider
その他の技術情報
ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ
ASP.NET サイト ナビゲーション プロバイダ
ASP.NET のサイト ナビゲーションの保護
アセンブリとグローバル アセンブリ キャッシュの使用

SiteMapProvider コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

SiteMapProvider クラスの新しいインスタンスを初期化します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New SiteMapProvider

C#

protected SiteMapProvider ()

C++

protected:
SiteMapProvider ()

J#

protected SiteMapProvider ()

JScript

protected function SiteMapProvider ()

解説

メモ
SiteMapProvider クラスは直接インスタンス化できません。SiteMapProvider コンストラクタは、StaticSiteMapProvider クラスの派生クラスのコンストラクタから呼び出されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SiteMapProvider クラス
SiteMapProvider メンバ
System.Web 名前空間

SiteMapProvider プロパティ

パブリック プロパティ

	名前	説明
	CurrentNode	現在要求されているページを表す SiteMapNode オブジェクトを取得します。
	Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 ( ProviderBase から継承されます。)
	EnableLocalization	SiteMapNode 属性のローカライズされた値が返されるかどうかを示すブール値を取得または設定します。
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。 ( ProviderBase から継承されます。)
	ParentProvider	現在のプロバイダの親 SiteMapProvider オブジェクトを取得または設定します。
	ResourceKey	SiteMapNode 属性のローカライズに使用するリソース キーを取得または設定します。
	RootNode	現在のプロバイダが表すサイト マップ データのルート SiteMapNode オブジェクトを取得します。
	RootProvider	現在のプロバイダ階層のルート SiteMapProvider オブジェクトを取得します。
	SecurityTrimmingEnabled	サイト マップ プロバイダがユーザーのロールに基づいてサイト マップ ノードをフィルタ処理するかどうかを示すブール値を取得します。

参照

関連項目

SiteMapProvider クラス
System.Web 名前空間
SiteMapProvider クラス
XmlSiteMapProvider

その他の技術情報

ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ
ASP.NET サイト ナビゲーション プロバイダ
ASP.NET のサイト ナビゲーションの保護
アセンブリとグローバル アセンブリ キャッシュの使用

SiteMapProvider メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindSiteMapNode	オーバーロードされます。 派生クラスでオーバーライドされた場合は、ページを表す SiteMapNode オブジェクトを取得します。
	FindSiteMapNodeFromKey	指定したキーに基づいて SiteMapNode オブジェクトを取得します。
	GetChildNodes	派生クラスでオーバーライドされた場合は、特定の SiteMapNode の子ノードを取得します。
	GetCurrentNodeAndHintAncestorNodes	現在要求されているページのノードを検索し、現在のページの親および先祖のサイト マップ ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetCurrentNodeAndHintNeighborhoodNodes	現在要求されているページのノードを検索し、現在のノードの近くのサイト マップ ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetParentNode	派生クラスでオーバーライドされた場合は、特定の SiteMapNode オブジェクトの親ノードを取得します。
	GetParentNodeRelativeToCurrentNodeAndHintDownFromParent	現在要求されているページの先祖ノードを検索し、その先祖の子孫ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetParentNodeRelativeToNodeAndHintDownFromParent	指定した SiteMapNode オブジェクトの先祖ノードを取得して、その子ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	HintAncestorNodes	サイト マップ プロバイダがオーバーライドして、指定した SiteMapNode オブジェクトの相対として 1 つ以上のレベルの親ノードと先祖ノードの最適化された取得を実行できるメソッドを提供します。
	HintNeighborhoodNodes	サイト マップ プロバイダがオーバーライドして、指定したノードの近くで見つかったノードの最適化された取得を実行できるメソッドを提供します。
	Initialize	オーバーライドされます。 SiteMapProvider 実装を初期化します。対象には、サイト マップ データを永続ストレージから読み込むために必要なリソースがすべて含まれます。
	IsAccessibleToUser	指定した SiteMapNode オブジェクトを指定したコンテキストでユーザーが表示できるかどうかを示すブール値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	AddNode	オーバーロードされます。 SiteMapNode オブジェクトを、サイト マップ プロバイダが管理するノード コレクションに追加します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetRootNodeCore	派生クラスでオーバーライドされた場合は、現在のプロバイダによって現在管理されている全ノードのルート ノードを取得します。
	GetRootNodeCoreFromProvider	指定したサイト マップ プロバイダによって現在管理されている全ノードのルート ノードを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	RemoveNode	指定された SiteMapNode オブジェクトを、サイト マップ プロバイダが管理するノード コレクションから削除します。
	ResolveSiteMapNode	SiteMapResolve イベントを発生させます。

参照

関連項目

SiteMapProvider クラス
System.Web 名前空間
SiteMapProvider クラス
XmlSiteMapProvider

その他の技術情報

ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ
ASP.NET サイト ナビゲーション プロバイダ
ASP.NET のサイト ナビゲーションの保護
アセンブリとグローバル アセンブリ キャッシュの使用

SiteMapProvider メンバ

すべてのサイト マップ データ プロバイダに共通基本クラスを提供します。また、SiteMap オブジェクトの永続記憶領域として ASP.NET サイト マップ インフラストラクチャと組み合わせて使用できるカスタム サイト マップ データ プロバイダを実装する手段を提供します。

SiteMapProvider データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	SiteMapProvider	SiteMapProvider クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	CurrentNode	現在要求されているページを表す SiteMapNode オブジェクトを取得します。
	Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。(ProviderBase から継承されます。)
	EnableLocalization	SiteMapNode 属性のローカライズされた値が返されるかどうかを示すブール値を取得または設定します。
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。(ProviderBase から継承されます。)
	ParentProvider	現在のプロバイダの親 SiteMapProvider オブジェクトを取得または設定します。
	ResourceKey	SiteMapNode 属性のローカライズに使用するリソース キーを取得または設定します。
	RootNode	現在のプロバイダが表すサイト マップ データのルート SiteMapNode オブジェクトを取得します。
	RootProvider	現在のプロバイダ階層のルート SiteMapProvider オブジェクトを取得します。
	SecurityTrimmingEnabled	サイト マップ プロバイダがユーザーのロールに基づいてサイト マップ ノードをフィルタ処理するかどうかを示すブール値を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindSiteMapNode	オーバーロードされます。 派生クラスでオーバーライドされた場合は、ページを表す SiteMapNode オブジェクトを取得します。
	FindSiteMapNodeFromKey	指定したキーに基づいて SiteMapNode オブジェクトを取得します。
	GetChildNodes	派生クラスでオーバーライドされた場合は、特定の SiteMapNode の子ノードを取得します。
	GetCurrentNodeAndHintAncestorNodes	現在要求されているページのノードを検索し、現在のページの親および先祖のサイト マップ ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetCurrentNodeAndHintNeighborhoodNodes	現在要求されているページのノードを検索し、現在のノードの近くのサイト マップ ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetParentNode	派生クラスでオーバーライドされた場合は、特定の SiteMapNode オブジェクトの親ノードを取得します。
	GetParentNodeRelativeToCurrentNodeAndHintDownFromParent	現在要求されているページの先祖ノードを検索し、その先祖の子孫ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetParentNodeRelativeToNodeAndHintDownFromParent	指定した SiteMapNode オブジェクトの先祖ノードを取得して、その子ノードをフェッチする際に、最適化された検索メソッドをサイト マップ プロバイダに提供します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	HintAncestorNodes	サイト マップ プロバイダがオーバーライドして、指定した SiteMapNode オブジェクトの相対として 1 つ以上のレベルの親ノードと先祖ノードの最適化された取得を実行できるメソッドを提供します。
	HintNeighborhoodNodes	サイト マップ プロバイダがオーバーライドして、指定したノードの近くで見つかったノードの最適化された取得を実行できるメソッドを提供します。
	Initialize	オーバーライドされます。 SiteMapProvider 実装を初期化します。対象には、サイト マップ データを永続ストレージから読み込むために必要なリソースがすべて含まれます。
	IsAccessibleToUser	指定した SiteMapNode オブジェクトを指定したコンテキストでユーザーが表示できるかどうかを示すブール値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	AddNode	オーバーロードされます。 SiteMapNode オブジェクトを、サイト マップ プロバイダが管理するノード コレクションに追加します。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetRootNodeCore	派生クラスでオーバーライドされた場合は、現在のプロバイダによって現在管理されている全ノードのルート ノードを取得します。
	GetRootNodeCoreFromProvider	指定したサイト マップ プロバイダによって現在管理されている全ノードのルート ノードを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	RemoveNode	指定された SiteMapNode オブジェクトを、サイト マップ プロバイダが管理するノード コレクションから削除します。
	ResolveSiteMapNode	SiteMapResolve イベントを発生させます。

パブリック イベント

	名前	説明
	SiteMapResolve	CurrentNode プロパティが呼び出されると発生します。

参照

関連項目

SiteMapProvider クラス
System.Web 名前空間
SiteMapProvider クラス
XmlSiteMapProvider

その他の技術情報

ASP.NET サイト ナビゲーションの概要
ASP.NET サイト マップ
ASP.NET サイト ナビゲーション プロバイダ
ASP.NET のサイト ナビゲーションの保護
アセンブリとグローバル アセンブリ キャッシュの使用