SPList.GetItems 方法 (String[])
从列表返回项的集合,但包括仅指定的字段值。
命名空间: Microsoft.SharePoint
程序集: Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)
语法
声明
Public Function GetItems ( _
ParamArray fields As String() _
) As SPListItemCollection
用法
Dim instance As SPList
Dim fields As String()
Dim returnValue As SPListItemCollection
returnValue = instance.GetItems(fields)
public SPListItemCollection GetItems(
params string[] fields
)
参数
fields
类型:[]要为其获取值的字段名称变量数。如果应检索所有字段,而是使用Items属性。
返回值
类型:Microsoft.SharePoint.SPListItemCollection
列表项的集合。
异常
异常 | 条件 |
---|---|
ArgumentNullException | fields是 null 。 |
备注
此方法从指定的字段创建一个新的SPQuery对象,并调用与该新对象中获取项的GetItems(SPQuery)方法。
此方法是访问Items属性,因为它仅获取指定字段的值比更有效。
示例
下面的示例是一个控制台应用程序,指定要从列表中检索的项目中返回的字段值。获取的数据后, 应用程序打印至控制台的简单报告。
Imports System
Imports Microsoft.SharePoint
Module ConsoleApp
Sub Main()
Using site As SPSite = New SPSite("https://localhost")
Using web As SPWeb = site.OpenWeb()
' Get data from a list.
Dim listUrl As String = web.ServerRelativeUrl + "/lists/tasks"
Dim list As SPList = web.GetList(listUrl)
Dim items As SPListItemCollection = list.GetItems("LinkTitle", "AssignedTo", "DueDate", "Status")
' Print a report header.
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}", _
"Assigned To", "Task", "Due Date", "Status")
' Print the details.
Dim item As SPListItem
For Each item In items
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}", _
item("AssignedTo"), item("LinkTitle"), item("DueDate"), item("Status"))
Next item
End Using
End Using
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
namespace Test
{
class ConsoleApp
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("https://localhost"))
{
using (SPWeb web = site.OpenWeb())
{
// Get data from a list.
string listUrl = web.ServerRelativeUrl + "/lists/tasks";
SPList list = web.GetList(listUrl);
SPListItemCollection items = list.GetItems("LinkTitle", "AssignedTo", "DueDate", "Status");
// Print a report header.
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}",
"Assigned To", "Task", "Due Date", "Status");
// Print the details.
foreach (SPListItem item in items)
{
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}",
item["AssignedTo"], item["LinkTitle"], item["DueDate"], item["Status"]);
}
}
}
Console.ReadLine();
}
}
}