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 。 會複製提供者、 Title 、 Url 、 Description 和 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如果 參數為 true ，則 Clone 方法會以遞迴方式複製所有直接上階節點，並將其與目前複製的節點產生關聯。 子節點不會複製。

Roles和 Attributes 集合會套用至新的集合。

另請參閱

• Clone()