SiteMapResolveEventArgsとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SiteMapResolveEventArgs クラス

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

SiteMapProvider クラスの CurrentNode プロパティを呼び出すことによって発生するイベントに関するデータを提供します。

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

Visual Basic (宣言)

Public Class SiteMapResolveEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As SiteMapResolveEventArgs

public class SiteMapResolveEventArgs : EventArgs

C++

public ref class SiteMapResolveEventArgs :
 public EventArgs

public class SiteMapResolveEventArgs extends
 EventArgs

JScript

public class SiteMapResolveEventArgs extends
 EventArgs

解説

SiteMapResolveEventArgs クラスを ResolveSiteMapNode メソッドで使用すると、SiteMapResolve イベントのサブスクライバで SiteMapNode クラスのインスタンスを返すことができます。SiteMapResolve イベントを処理するイベントハンドラデリゲートを追加することによって、カスタムサイトマッププロバイダを実装しなくてもページの SiteMapNode 表現を作成できます。

使用例

SiteMapResolve イベントを ASP.NET Web ページで処理して、SiteMapPath コントロールなどのサイトナビゲーションコントロールにより表示される URL を変更する方法を示すコード例を次に示します。この例では、現在のページはオンラインの掲示板またはフォーラムの投稿ページです。より意味のあるサイトナビゲーションを実現するため、ナビゲーションコントロールにより表示されるノードの URL が、コンテキストに関連するクエリ文字列に付加されます。

メモ CurrentNode プロパティに SiteMapResolveEventHandler クラスの中からアクセスしても安全です。この場合、ASP.NET サイトナビゲーションインフラストラクチャが無限の再帰を防ぎます。

Visual Basic

Private Sub Page_Load(ByVal
 sender As Object, ByVal
 e As EventArgs)

    ' The ExpandForumPaths method is called to handle
    ' the SiteMapResolve event.
    AddHandler SiteMap.SiteMapResolve, AddressOf
 Me.ExpandForumPaths

End Sub

Private Function ExpandForumPaths(ByVal
 sender As Object, ByVal
 e As SiteMapResolveEventArgs) As SiteMapNode
    ' The current node represents a Post page in a bulletin board forum.
    ' Clone the current node and all of its relevant parents. This
    ' returns a site map node that a developer can then
    ' walk, modifying each node.Url property in turn.
    ' Since the cloned nodes are separate from the underlying
    ' site navigation structure, the fixups that are made do not
    ' effect the overall site navigation structure.
    Dim currentNode As SiteMapNode = SiteMap.CurrentNode.Clone(True)
    Dim tempNode As SiteMapNode = currentNode

    ' Obtain the recent IDs.
    Dim forumGroupID As Integer
 = GetMostRecentForumGroupID()
    Dim forumID As Integer
 = GetMostRecentForumID(forumGroupID)
    Dim postID As Integer
 = GetMostRecentPostID(forumID)

    ' The current node, and its parents, can be modified to include
    ' dynamic querystring information relevant to the currently
    ' executing request.
    If Not (0 = postID) Then
        tempNode.Url = tempNode.Url & "?PostID="
 & postID.ToString()
    End If

    tempNode = tempNode.ParentNode
    If Not (0 = forumID) And
 Not (tempNode Is Nothing)
 Then
        tempNode.Url = tempNode.Url & "?ForumID="
 & forumID.ToString()
    End If

    tempNode = tempNode.ParentNode
    If Not (0 = ForumGroupID) And
 Not (tempNode Is Nothing)
 Then
        tempNode.Url = tempNode.Url & "?ForumGroupID="
 & forumGroupID.ToString()
    End If

    Return currentNode

End Function

private void Page_Load(object sender, EventArgs
 e)
{
    // The ExpandForumPaths method is called to handle
    // the SiteMapResolve event.
    SiteMap.SiteMapResolve +=
      new SiteMapResolveEventHandler(this.ExpandForumPaths);
}

private SiteMapNode ExpandForumPaths(Object sender, SiteMapResolveEventArgs
 e)
{
    // The current node represents a Post page in a bulletin board forum.
    // Clone the current node and all of its relevant parents. This
    // returns a site map node that a developer can then
    // walk, modifying each node.Url property in turn.
    // Since the cloned nodes are separate from the underlying
    // site navigation structure, the fixups that are made do not
    // effect the overall site navigation structure.
    SiteMapNode currentNode = SiteMap.CurrentNode.Clone(true);
    SiteMapNode tempNode = currentNode;

    // Obtain the recent IDs.
    int forumGroupID = GetMostRecentForumGroupID();
    int forumID = GetMostRecentForumID(forumGroupID);
    int postID = GetMostRecentPostID(forumID);

    // The current node, and its parents, can be modified to include
    // dynamic querystring information relevant to the currently
    // executing request.
    if (0 != postID)
    {
        tempNode.Url = tempNode.Url + "?PostID=" + postID.ToString();
    }

    if ((null != (tempNode = tempNode.ParentNode))
 &&
        (0 != forumID))
    {
        tempNode.Url = tempNode.Url + "?ForumID=" + forumID.ToString();
    }

    if ((null != (tempNode = tempNode.ParentNode))
 &&
        (0 != forumGroupID))
    {
        tempNode.Url = tempNode.Url + "?ForumGroupID=" + forumGroupID.ToString();
    }

    return currentNode;
}

.NET Framework のセキュリティ

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

継承階層

System.Object
System.EventArgs
System.Web.SiteMapResolveEventArgs

スレッドセーフ

この型の 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

参照

関連項目
SiteMapResolveEventArgs メンバ
System.Web 名前空間
SiteMapResolveEventHandler
SiteMap.SiteMapResolve イベント

SiteMapResolveEventArgs コンストラクタ

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

指定した HttpContext オブジェクトと SiteMapProvider オブジェクトを使用して、SiteMapResolveEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    context As HttpContext, _
    provider As SiteMapProvider _
)

Visual Basic (使用法)

Dim context As HttpContext
Dim provider As SiteMapProvider

Dim instance As New SiteMapResolveEventArgs(context,
 provider)

public SiteMapResolveEventArgs (
    HttpContext context,
    SiteMapProvider provider
)

C++

public:
SiteMapResolveEventArgs (
    HttpContext^ context, 
    SiteMapProvider^ provider
)

public SiteMapResolveEventArgs (
    HttpContext context, 
    SiteMapProvider provider
)

JScript

public function SiteMapResolveEventArgs (
    context : HttpContext, 
    provider : SiteMapProvider
)

パラメータ

context: 現在のページ要求のコンテキストを表す HttpContext。

provider: SiteMapResolve イベントの発生元の SiteMapProvider。

解説

context パラメータと provider パラメータが両方とも null 参照 (Visual Basic では Nothing) でもかまいません。

XmlSiteMapProvider オブジェクトは、SiteMapResolveEventArgs クラスの新しいインスタンスを null 参照 (Visual Basic では Nothing) ではない値で初期化します。

プラットフォーム

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
サポート対象 : 2.0

参照

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

SiteMapResolveEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Context	要求されたノードが表すページ要求のコンテキストを取得します。
	Provider	SiteMapResolve イベントを発生させる SiteMapProvider オブジェクトを取得します。

参照

SiteMapResolveEventArgs メソッド

パブリックメソッドパブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

SiteMapResolveEventArgs メンバ

SiteMapProvider クラスの CurrentNode プロパティを呼び出すことによって発生するイベントに関するデータを提供します。

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

パブリックコンストラクタ

	名前	説明
	SiteMapResolveEventArgs	指定した HttpContext オブジェクトと SiteMapProvider オブジェクトを使用して、SiteMapResolveEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	Context	要求されたノードが表すページ要求のコンテキストを取得します。
	Provider	SiteMapResolve イベントを発生させる SiteMapProvider オブジェクトを取得します。

パブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

SiteMapResolveEventArgsとは？わかりやすく解説

SiteMapResolveEventArgs クラス

SiteMapResolveEventArgs コンストラクタ

SiteMapResolveEventArgs プロパティ

関連項目

SiteMapResolveEventArgs メソッド

関連項目

SiteMapResolveEventArgs メンバ

関連項目

「SiteMapResolveEventArgs」の関連用語


	© 2025 Microsoft.All rights reserved.

SiteMapResolveEventArgsとは？ わかりやすく解説

SiteMapResolveEventArgs クラス

SiteMapResolveEventArgs コンストラクタ

SiteMapResolveEventArgs プロパティ

関連項目

SiteMapResolveEventArgs メソッド

関連項目

SiteMapResolveEventArgs メンバ

関連項目

急上昇のことば

「SiteMapResolveEventArgs」の関連用語

SiteMapResolveEventArgsとは？わかりやすく解説