ViewCollection.Add 方法
將新的清單檢視新增至集合。
命名空間: Microsoft.SharePoint.Client
組件： Microsoft.SharePoint.Client.Silverlight (在 Microsoft.SharePoint.Client.Silverlight.dll 中); Microsoft.SharePoint.Client.Phone (在 Microsoft.SharePoint.Client.Phone.dll 中) Microsoft.SharePoint.Client (在 Microsoft.SharePoint.Client.dll 中)
語法
'宣告
Public Function Add ( _
parameters As ViewCreationInformation _
) As View
'用途
Dim instance As ViewCollection
Dim parameters As ViewCreationInformation
Dim returnValue As View
returnValue = instance.Add(parameters)
public View Add(
ViewCreationInformation parameters
)
參數
parameters
類型：Microsoft.SharePoint.Client.ViewCreationInformation指定新的清單檢視。
傳回值
類型：Microsoft.SharePoint.Client.View
傳回代表的清單檢視新增至集合View執行個體。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| [System.ArgumentException] | 欄位的欄位內部名稱不在 [清單] 檢視中。錯誤碼 ︰-2147024809。 |
| [System.InvalidOperationException] | 輸入新的清單檢視的不允許的清單。錯誤碼:-1。 |
| [System.IO.DirectoryNotFoundException] | 清單不存在。錯誤碼 ︰-2147024893。 |
| [System.UnauthorizedAccessException] | 目前的使用者會有足夠的權限。錯誤碼 ︰-2147024891。 |
備註
它不能null 參考 (未執行任何動作 於 Visual Basic 中)。
範例
此範例中的程式碼新增至工作清單中指定的網站，檢視，並顯示該清單中的目前檢視。
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);
}
}
}