共用方式為

ListCollection.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 ListCreationInformation _
) As List
'用途
Dim instance As ListCollection
Dim parameters As ListCreationInformation
Dim returnValue As List

returnValue = instance.Add(parameters)

public List Add(
    ListCreationInformation parameters
)

參數

傳回值

類型：Microsoft.SharePoint.Client.List
傳回代表建立清單或文件庫的List執行個體。

例外狀況

例外狀況 條件
MetadataObjectNotFoundException

ListCreationInformation.Url不正確。
[Microsoft.BusinessData.MetadataModel.MetadataObjectNotFoundException]

在伺服器上沒有 ListCreationInformation.DataSourceProperties 或指定的 SpecificFinder 中指定的實體。錯誤碼:-1。
[Microsoft.SharePoint.SPException]

在 ListCreationInformation.DataSourceProperties 中指定的實體沒有指定 SpecificFinder 的檢視。錯誤碼 ︰-2146232832。
SPException

不存在的位置清單、 目前的使用者沒有足夠的權限執行的作業、 ListCreationInformation.Title是null 參考 (未執行任何動作 於 Visual Basic 中)、 ListCreationInformation.Url不正確，或在網站中已有標題的另一個清單。錯誤碼 ︰-2130575342。
[Microsoft.SharePoint.SPException]

清單伺服器範本不是有效的。錯誤碼 ︰-2130575237。
[Microsoft.SharePoint.SPException]

功能不存在。錯誤碼 ︰-2130246262。
UnauthorizedAccessException

清單伺服器範本不正確。

目前的使用者會有足夠的權限。錯誤碼 ︰-2147024891。

範例

此範例中的程式碼會建立兩個新的宣告清單，並將它們新增至清單的集合目前的網站。

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class ListCollection_AddExample

    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;
            ListCollection collList = site.Lists;

            ListCreationInformation lci1 = new ListCreationInformation();
            lci1.Title = "New Announcements";
            lci1.TemplateType = (int)ListTemplateType.Announcements;
            site.Lists.Add(lci1);

            ListCreationInformation lci2 = new ListCreationInformation();
            lci2.Title = "Old Announcements";
            lci2.TemplateType = (int)ListTemplateType.Announcements;
            site.Lists.Add(lci2);

            clientContext.Load(collList);
            clientContext.ExecuteQuery();

            Console.WriteLine("Lists on the current site:\n\n");
            foreach (List targetList in collList)
               Console.WriteLine(targetList.Title);

        }
    }
}

請參閱

參照

ListCollection 類別

ListCollection 成員

Microsoft.SharePoint.Client 命名空間