ViewCollection.Add Method
Adds a new list view 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 ViewCreationInformation _
) As View
'Usage
Dim instance As ViewCollection
Dim parameters As ViewCreationInformation
Dim returnValue As View
returnValue = instance.Add(parameters)
[RemoteAttribute]
public View Add(
ViewCreationInformation parameters
)
Parameters
parameters
Type: Microsoft.SharePoint.Client.ViewCreationInformationSpecifies the new list view.
Return Value
Type: Microsoft.SharePoint.Client.View
Returns a View instance representing the addition of a new list view to the collection.
Exceptions
| Exception | Condition |
|---|---|
| [System.ArgumentException] | Field internal name for field is not in the list view. Error code: -2147024809. |
| [System.InvalidOperationException] | Type of the new list view is not allowed for the list. Error code: -1. |
| [System.IO.DirectoryNotFoundException] | List does not exist. Error code: -2147024893. |
| [System.UnauthorizedAccessException] | The current user has insufficient permissions. Error code: -2147024891. |
Remarks
It must not be a null reference (Nothing in Visual Basic).
Examples
This code example adds a new view to the Tasks list of the specified site, and displays the list’s current views.
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class ViewCollection_AddExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
List targetList = site.Lists.GetByTitle("Tasks");
ViewCollection collView = targetList.Views;
ViewCreationInformation viewInfo = new ViewCreationInformation();
viewInfo.Title = "MyView";
collView.Add(viewInfo);
clientContext.Load(collView);
clientContext.ExecuteQuery();
Console.WriteLine("Tasks list current views:\n\n");
foreach (View oneView in collView)
Console.WriteLine(oneView.Title);
}
}
}