SiteMapNode.Clone Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un nuovo nodo che è una copia del nodo corrente.
Overload
Clone() |
Crea un nuovo nodo che è una copia del nodo corrente. |
Clone(Boolean) |
Crea una nuova copia del nodo corrente, con la possibilità di duplicare tutti i nodi padre e i nodi predecessore del nodo corrente. |
Clone()
Crea un nuovo nodo che è una copia del nodo corrente.
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
Restituisce
Nuovo nodo che è una copia del nodo corrente.
Commenti
Chiama il metodo con il Clone parametro impostato su false
. Il provider, Title, Url, Descriptione Key le proprietà vengono copiati. Le Roles raccolte e Attributes vengono copiate in nuove raccolte. I nodi predecessori e figlio non vengono clonati.
Vedi anche
Si applica a
Clone(Boolean)
Crea una nuova copia del nodo corrente, con la possibilità di duplicare tutti i nodi padre e i nodi predecessore del nodo corrente.
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
Parametri
- cloneParentNodes
- Boolean
true
per duplicare tutti i nodi padre e i nodi predecessore del nodo corrente; in caso contrario, false
.
Restituisce
Nuovo nodo che è una copia del nodo corrente.
Esempio
Nell'esempio di codice seguente viene illustrato come chiamare il Clone metodo per creare un nodo mappa del sito duplicato dal nodo corrente. Il ExpandForumPaths
metodo viene registrato per gestire l'evento SiteMapResolve . Usa il Clone metodo per creare una copia funzionante del nodo mappa del sito corrente, modificare gli attributi in base ai dati di personalizzazione e restituire la copia di lavoro.
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
Commenti
Se il parametro è true
, il ClonecloneParentNodes
metodo clona in modo ricorsivo tutti i nodi del predecessore diretto e li associa al nodo clonato corrente. I nodi figlio non vengono clonati.
Le Roles raccolte e Attributes vengono applicate alle nuove raccolte.