Метод SPList.GetItems (String[])

Статья
05/13/2015

Возвращает коллекцию элементов в списке, но включает в себя только те значения указанного поля.

Пространство имен: 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();
      }
   }
}