ContentTypeCollection.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 ContentTypeCreationInformation _
) As ContentType
'用途
Dim instance As ContentTypeCollection
Dim parameters As ContentTypeCreationInformation
Dim returnValue As ContentType
returnValue = instance.Add(parameters)
public ContentType Add(
ContentTypeCreationInformation parameters
)
參數
parameters
類型:Microsoft.SharePoint.Client.ContentTypeCreationInformationContentTypeCreationInformation物件代表與內容類型的相關資訊。它會指定將用來建構新內容類型的屬性。它不能null 參考 (未執行任何動作 於 Visual Basic 中)。內容類型的範圍其ParentContentType屬性不能的上層內容類型集合中的上階。ParentContentType屬性會指定建構的內容類型的上層內容類型。
傳回值
類型:Microsoft.SharePoint.Client.ContentType
若要新增至集合新ContentType物件。
例外狀況
例外狀況 | 條件 |
---|---|
[ServerException] | 集合是唯讀的。 |
[SPException] | 集合中存在的參數Name屬性所指定的名稱與內容類型。錯誤碼 ︰ 183。 |
範例
此程式碼範例初始化自訂內容類型,將它加入各種內容類型,並顯示指定的網站的內容類型的名稱。
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class ContentTypeCollectionAddExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
ContentTypeCollection collContentType = site.ContentTypes;
// Initialize a new content type.
ContentTypeCreationInformation contentInfo = new ContentTypeCreationInformation();
contentInfo.Name = "myContentType";
contentInfo.Description = "My custom content type";
ContentType contentType = collContentType.Add(contentInfo);
clientContext.Load(collContentType);
clientContext.ExecuteQuery();
foreach (ContentType myType in collContentType)
Console.WriteLine("Content Type Name: {0}", myType.Name);
}
}
}