NavigationNodeCollection.Add Method

Creates a navigation node object and adds it to the collection.

Namespace:  Microsoft.SharePoint.Client
Assemblies:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)

Syntax

'Declaration
<RemoteAttribute> _
Public Function Add ( _
    parameters As NavigationNodeCreationInformation _
) As NavigationNode
'Usage
Dim instance As NavigationNodeCollection
Dim parameters As NavigationNodeCreationInformation
Dim returnValue As NavigationNode

returnValue = instance.Add(parameters)

[RemoteAttribute]
public NavigationNode Add(
    NavigationNodeCreationInformation parameters
)

Parameters

• parameters
  Type: Microsoft.SharePoint.Client.NavigationNodeCreationInformation

  Describes the node to be created.

  It must not be a null reference (Nothing in Visual Basic).

Return Value

Type: Microsoft.SharePoint.Client.NavigationNode
Returns a NavigationNode instance representing the creation of a navigation node object and adds it to the collection.

Examples

This code example adds a node to the Quick Launch area of the specified site and displays the current Quick Launch nodes.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class NavigationNodeCollection_AddExample
    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;

            // Get the Quick Launch navigation node collection.
            NavigationNodeCollection collQuickLaunchNode = site.Navigation.QuickLaunch;

            // Set properties for a new navigation node.
            NavigationNodeCreationInformation ciNavicationNode = new NavigationNodeCreationInformation();
            ciNavicationNode.Title = "New Node";
            ciNavicationNode.Url = "https://localhost";
            // Create node as the last node in the collection.
            ciNavicationNode.AsLastNode = true;
            collQuickLaunchNode.Add(ciNavicationNode);

            clientContext.Load(collQuickLaunchNode);
            clientContext.ExecuteQuery();

            Console.WriteLine("Current nodes:\n");
            foreach (NavigationNode navNode in collQuickLaunchNode)
               Console.WriteLine(navNode.Title);
        }
    }
}

See Also

Reference

NavigationNodeCollection Class

NavigationNodeCollection Members

Microsoft.SharePoint.Client Namespace