(String[]) del método SPList.GetItems

Artículo
05/13/2015

Devuelve una colección de elementos de la lista, pero incluye sólo los valores de campo especificado.

Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
Tipo: []

Un número variable de nombres de campo para el que se va a obtener valores. Si se deben recuperar todos los campos, utilice la propiedad Items en su lugar.

Valor devuelto

Tipo: Microsoft.SharePoint.SPListItemCollection
Una colección de elementos de lista.

Excepciones

Excepción	Condición
ArgumentNullException	fields es nulo .

Comentarios

Este método crea un nuevo objeto SPQuery a partir de los campos especificados y llama al método GetItems(SPQuery) con el nuevo objeto para obtener los elementos.

Este método es más eficiente que el acceso a la propiedad Items porque sólo busca los valores de los campos especificados.

Ejemplos

En el siguiente ejemplo es una aplicación de consola que especifica los valores de campo para devolver en elementos recuperados de una lista. Después de recuperar los datos, la aplicación imprime un informe sencillo en la consola.

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