ListItem 類別

表示清單中的項目或資料列。

繼承階層架構

System.Object
  Microsoft.SharePoint.Client.ClientObject
    Microsoft.SharePoint.Client.SecurableObject
      Microsoft.SharePoint.Client.ListItem

命名空間:  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 Class ListItem _
    Inherits SecurableObject
'用途
Dim instance As ListItem

public class ListItem : SecurableObject

備註

包含 CSOM expando 欄位對應到上層清單中所定義的欄位。CSOM expando 欄位名稱的清單中所定義的欄位名稱，而 CSOM expando 欄位值是欄位中的值清單項目。下表中定義的對應欄位類型之間的值。

欄位類型	CSOM Expando 欄位值類型	意義
Integer	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM Int32。	欄位可讓整數值。
文字	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	欄位可讓限制長度的文字字串。
注意事項	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	欄位可讓大量文字。
DateTime	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 日期時間。	完整日期和時間值，以及僅日期的值，可讓功能變數。
計數器	它必須 CSOM Int32。	計數器遞增的整數欄位，而具有唯一值相對於其他儲存在清單中的欄位的值。[計數器僅用於清單項目識別碼] 欄位中，而不是用於其他位置。
選項	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	欄位可讓一組建議的值從選取範圍。選擇欄位支援的欄位層級設定，指定是否支援任意值。
Lookup	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 物件。	欄位允許的參照另一個清單項目。該欄位支援清單識別碼的規格目標清單。選擇性網站識別碼，也可以指定，以指定包含查閱的目標清單的網站。
Boolean	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。	功能變數，允許true或false的值。
Number	定義其值時，它必須是 CSOM null，否則必須 CSOM 雙。	欄位可讓正數或負數。數字欄位支援的功能變數層級設定用於指定的小數位數顯示。
貨幣	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 雙。	允許與貨幣相關的資料欄位。[貨幣] 欄位有 CurrencyLocaleId 屬性會使用貨幣的地區設定識別碼。
URL	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 物件。	URL 和 URL 的選擇性描述，可讓功能變數。
計算	N/A	功能變數會呈現輸出根據的其他資料行的值。
執行緒處理	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	包含上的討論區中的項目執行緒處理資料。
Guid	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM GUID。	指定欄位的值是 GUID。
MultiChoice	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 陣列。	欄位可讓一組指定選擇一或多個值。 MultiChoice 欄位也支援任意值。
GridChoice	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 陣列。	格線的選項清單中支援的多個數值的比例。
計算方式	N/A	欄位值會根據的其他資料行值計算。
File	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	指定可以用來擷取該檔案的內容檔案的參考。
Attachments	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。	功能變數說明一或多個檔案是否與項目相關聯。 如需有關附件，請參閱附件。true如果清單項目有附件及false如果清單項目沒有附件。
User	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 物件。	在 [使用者資訊清單中的特定使用者查閱。
週期	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。	指定欄位是否包含循環模式的項目。
CrossProjectLink	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。	欄位可讓會議工作區網站的連結。
ModStat	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM int32。	在文件指定仲裁程序的目前狀態。
錯誤	N/A	指定錯誤。值 = 24。
ContentTypeId	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 物件。	] 欄位包含的內容類型識別碼建立項目。ContentTypeId 符合 ContentTypeId 中定義的結構。
PageSeparator	N/A	代表頁面分隔符號問卷清單中的預留位置。PageSeparator 只被用來搭配問卷清單。
ThreadIndex	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。	包含編譯的討論區中的執行緒索引。
WorkflowStatus	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM Int32。	包含特定項目執行工作流程的狀態。
AllDayEvent	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。	AllDayEvent 欄位只會用與事件清單搭配使用。true如果項目為全天事件 （也就是不會發生期間一組特定的一天的時間）。
WorkflowEventType	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM Int32。	類型的歷程記錄的工作流程事件的描述。如需詳細資訊，請參閱 WorkflowEventType 列舉。
功能	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 陣列。
FreeBusy	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。
Overbook	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。
機密	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。
WhatsNew	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。
DueDate	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 日期時間。
AllowEditing	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須 CSOM 布林值。
SendTo	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 陣列
確認	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。
CallTo	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 陣列。
CallTime	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 日期時間。
Whereabout	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。
寄件者	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 日期時間。
直到	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 日期時間。
ContactInfo	定義其值時，它必須是 CSOM null 參考 (未執行任何動作 於 Visual Basic 中)，否則必須是 CSOM 字串。

範例

此範例中的程式碼新增指定的網站上的 [宣告] 清單項目。

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class ListItemExample
    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;
            List targetList = site.Lists.GetByTitle("Announcements");

            ListItemCreationInformation itemCreateInfo = new ListItemCreationInformation();
            ListItem newListItem = targetList.AddItem(itemCreateInfo);
            newListItem["Title"] = "New Announcement";
            newListItem["Body"] = "Hello World!";
            newListItem.Update();

            clientContext.Load(newListItem);
            clientContext.ExecuteQuery();

            Console.WriteLine("Announcement created! \n\n"
               + "ID: " + newListItem.Id + "\nTitle: " + newListItem["Title"]);
        }
    }
}

執行緒安全

這類型的任何公用 static (共用 於 Visual Basic 中) 成員是安全執行緒。不保證任何執行個體成員都是安全執行緒。

請參閱

參照

ListItem 成員

Microsoft.SharePoint.Client 命名空間