List.GetItems 方法
從以指定查詢為基礎的清單傳回一群項目。
命名空間: 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 GetItems ( _
query As CamlQuery _
) As ListItemCollection
'用途
Dim instance As List
Dim query As CamlQuery
Dim returnValue As ListItemCollection
returnValue = instance.GetItems(query)
public ListItemCollection GetItems(
CamlQuery query
)
參數
query
類型:Microsoft.SharePoint.Client.CamlQuery包含查詢CamlQuery物件。
傳回值
類型:Microsoft.SharePoint.Client.ListItemCollection
表示項目ListItemCollection物件。
例外狀況
例外狀況 | 條件 |
---|---|
SPException | 在清單中沒有指定查詢中的欄位。錯誤碼 ︰-2130575340。 |
SPQueryThrottledException | 節流限制超出作業。錯誤碼:-2147024860.Or 有會缺少資源可用於處理要求。錯誤碼 ︰-2147024749。 |
UnauthorizedAccessException | 使用者會有足夠的權限執行的作業。錯誤碼 ︰-2147024891。 |
備註
它不能null 參考 (未執行任何動作 於 Visual Basic 中)。
範例
此程式碼範例會取得的相關公告,目前網站的包含指定的字串。
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class List_getItemsExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
List targetList = site.Lists.GetByTitle("Announcements");
CamlQuery query = new CamlQuery();
query.ViewXml = "<View><Query><Where><Contains><FieldRef Name='Title'/><Value Type='Text'>announce</Value></Contains></Where></Query></View>";
ListItemCollection collListItem = targetList.GetItems(query);
clientContext.Load(collListItem);
clientContext.ExecuteQuery();
if (collListItem.Count == 0)
{
Console.WriteLine("No items containing 'announce' found.");
}
else
{
Console.WriteLine("Items containing 'announce' found:\n");
foreach (ListItem targetListItem in collListItem)
Console.WriteLine(targetListItem["Title"]);
}
}
}
}