SPList.GetItems-Methode (String[])

Gibt eine Auflistung von Elementen aus der Liste, jedoch nur die angegebenen Werte enthält.

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

Syntax

'Declaration
Public Function GetItems ( _
    ParamArray fields As String() _
) As SPListItemCollection
'Usage
Dim instance As SPList
Dim fields As String()
Dim returnValue As SPListItemCollection

returnValue = instance.GetItems(fields)

public SPListItemCollection GetItems(
    params string[] fields
)

Parameter

• fields
  Typ: []

  Eine Variable Anzahl von Feldnamen für das Abrufen von Werten. Wenn alle Felder abgerufen werden sollen, verwenden Sie stattdessen die Items -Eigenschaft.

Rückgabewert

Typ: Microsoft.SharePoint.SPListItemCollection
Eine Auflistung von Listenelementen.

Ausnahmen

Hinweise

Diese Methode erstellt ein neues SPQuery -Objekt aus den angegebenen Feldern und ruft die GetItems(SPQuery) -Methode mit diesem neuen Objekt der Elemente abgerufen.

Diese Methode ist effizienter als der Zugriff auf die Items -Eigenschaft, da es nur für die angegebenen Felder die Werte abruft.

Beispiele

Im folgende Beispiel ist eine Konsolenanwendung, die Feldwerte für die zurückzugebenden Elemente aus einer Liste abgerufen angibt. Nach dem Abrufen der Daten, druckt die Anwendung einen einfachen Bericht an die Konsole.

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

Siehe auch

Referenz

SPList Klasse

SPList-Member

GetItems-Überladung

Microsoft.SharePoint-Namespace