SiteMapNode.Clone メソッド

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

現在のノードのコピーである新しいノードを作成します。

オーバーロード

Clone()	現在のノードのコピーである新しいノードを作成します。
Clone(Boolean)	現在のノードのコピーである新しいノードを作成します。オプションで、現在のノードのすべての親ノードと先祖ノードを複製できます。

Clone()

現在のノードのコピーである新しいノードを作成します。

public:
 virtual System::Web::SiteMapNode ^ Clone();

public virtual System.Web.SiteMapNode Clone ();

abstract member Clone : unit -> System.Web.SiteMapNode
override this.Clone : unit -> System.Web.SiteMapNode

Public Overridable Function Clone () As SiteMapNode

戻り値

SiteMapNode

現在のノードのコピーである新しいノード。

注釈

パラメーターを に Clone 設定して メソッドを false呼び出します。 プロバイダー、TitleUrlDescription、および Key の各プロパティがコピーされます。 Rolesコレクションと Attributes コレクションは、新しいコレクションにコピーされます。 先祖ノードと子ノードは複製されません。

こちらもご覧ください

• Clone(Boolean)

Clone(Boolean)

現在のノードのコピーである新しいノードを作成します。オプションで、現在のノードのすべての親ノードと先祖ノードを複製できます。

public:
 virtual System::Web::SiteMapNode ^ Clone(bool cloneParentNodes);

public virtual System.Web.SiteMapNode Clone (bool cloneParentNodes);

abstract member Clone : bool -> System.Web.SiteMapNode
override this.Clone : bool -> System.Web.SiteMapNode

Public Overridable Function Clone (cloneParentNodes As Boolean) As SiteMapNode

パラメーター

cloneParentNodes

Boolean

現在のノードのすべての親ノードと先祖ノードを複製する場合は true。それ以外の場合は false。

戻り値

SiteMapNode

現在のノードのコピーである新しいノード。

例

次のコード例では、 メソッドを呼び出して、現在の Clone ノードから重複するサイト マップ ノードを作成する方法を示します。 メソッドは ExpandForumPaths 、イベントを処理 SiteMapResolve するために登録されます。 メソッドを Clone 使用して、現在のサイト マップ ノードの作業コピーを作成し、パーソナル化データに基づいて属性を変更し、作業コピーを返します。

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;
}

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

注釈

パラメーターが cloneParentNodes の場合、 メソッドはtrueClone、すべての直接先祖ノードを再帰的に複製し、それらを現在の複製されたノードに関連付けます。 子ノードは複製されません。

Rolesコレクションと Attributes コレクションは、新しいコレクションに適用されます。

こちらもご覧ください

• Clone()