通过

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是空引用（无 在 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 命名空间