SPList.GetItems method (String[])

Artigo
05/12/2015

Retorna uma coleção de itens da lista, mas inclui apenas os valores do campo especificado.

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Function GetItems ( _
    ParamArray fields As String() _
) As SPListItemCollection
'Uso
Dim instance As SPList
Dim fields As String()
Dim returnValue As SPListItemCollection

returnValue = instance.GetItems(fields)

public SPListItemCollection GetItems(
    params string[] fields
)

Parâmetros

fields
Type: []

Um número variável de nomes de campo para o qual obter valores. Se todos os campos devem ser recuperados, use a propriedade Items .

Valor retornado

Type: Microsoft.SharePoint.SPListItemCollection
Uma coleção de itens de lista.

Exceptions

Exception	Condition
ArgumentNullException	fields é null .

Comentários

Este método cria um novo objeto de SPQuery dos campos especificados e chama o método GetItems(SPQuery) com esse novo objeto para obter os itens.

Esse método é mais eficiente do que acessar a propriedade Items porque ele buscar apenas os valores para os campos especificados.

Examples

O exemplo a seguir é um aplicativo de console que especifica os valores de campo para retornar em recuperada de uma lista de itens. Após buscar os dados, o aplicativo imprime um relatório simples no console.

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();
      }
   }
}