Метод SPWeb.GetListItemFields

Статья
05/13/2015

Возвращает элемент списка, связанного с указанного сервера относительный URL-адрес, возвращая данные только указанные поля.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function GetListItemFields ( _
    strUrl As String, _
    ParamArray fields As String() _
) As SPListItem
'Применение
Dim instance As SPWeb
Dim strUrl As String
Dim fields As String()
Dim returnValue As SPListItem

returnValue = instance.GetListItemFields(strUrl, _
    fields)

public SPListItem GetListItemFields(
    string strUrl,
    params string[] fields
)

Параметры

strUrl
Тип: System.String

Сервер относительный URL-адрес, например "/sites/MySite/Shared Documents/MyDocument.docx".

fields
Тип: []

Имена полей, для которых значения возвращаются в элементе списка.

Возвращаемое значение

Тип: Microsoft.SharePoint.SPListItem
Элемент списка.

Исключения

Исключение	Условие
ArgumentNullException	fields или strUrl — null .

Замечания

Если fields является пустой массив, этот метод не возвращает значения для всех полей для элемента списка.

Этот метод возвращает только значения для указанного поля в элементе списка. Чтобы получить элемент списка на основании идентификатор элемента списка, используйте метод GetItemByIdSelectedFields(Int32, []) .

Примеры

Следующий пример является консольным приложением, которое выбирает элемент списка, указав URL-адрес и массив имен полей. После получения товара, приложение выводит на консоль значений полей.

Imports System
Imports Microsoft.SharePoint

Module ConsoleApp
   Sub Main()
      Using site As SPSite = New SPSite("https://localhost")
         Using web As SPWeb = site.OpenWeb()

            ' Build a server-relative Url for a list item.
            Dim itemUrl As String = web.RootFolder.ServerRelativeUrl
            itemUrl += "_catalogs/masterpage/default.master"

            ' Make a list of fields to fetch.
            Dim itemFields() As String = {"ContentTypeId", _
                                          "ContentType", _
                                          "HTML_x0020_File_x0020_Type", _
                                          "EncodedAbsUrl", _
                                          "FileLeafRef", _
                                          "UniqueId", _
                                          "FileSizeDisplay"}

            ' Get the list item.
            Dim item As SPListItem = web.GetListItemFields(itemUrl, itemFields)

            ' Print the values to the console.
            Dim fieldName As String
            For Each fieldName In itemFields
               Console.WriteLine("{0} = {1}", fieldName, item(fieldName))
            Next

         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())
            {
               // Build a server-relative Url for a list item.
               string itemUrl = web.RootFolder.ServerRelativeUrl;
               itemUrl += "_catalogs/masterpage/default.master";

               // Make a list of fields to fetch.
               string[] itemFields = 
               {
                  "ContentTypeId",
                  "ContentType",
                  "HTML_x0020_File_x0020_Type",
                  "EncodedAbsUrl",
                  "FileLeafRef",
                  "UniqueId",
                  "FileSizeDisplay"
               };

               // Get the list item.
               SPListItem item = web.GetListItemFields(itemUrl, itemFields);

               // Print the values to the console.
               foreach (string fieldName in itemFields)
                  Console.WriteLine("{0} = {1}", fieldName, item[fieldName]);
            }
         }
         Console.ReadLine();
      }
   }
}

Imports System
Imports System.Collections.Generic
Imports System.Globalization
Imports System.Text
Imports Microsoft.SharePoint

Module ConsoleApp

    Sub Main()
        Using site As New SPSite("https://localhost")
            Using web As SPWeb = site.OpenWeb()

                If web.IsMultilingual Then
                    Dim sb As New StringBuilder()
                    Dim sep As String = ", "

                    Dim cultures As IEnumerable(Of CultureInfo) = web.SupportedUICultures

                    For Each culture As CultureInfo In cultures
                        sb.Append(culture.Name)
                        sb.Append(sep)
                    Next

                    Dim str As String = sb.ToString().Trim(sep.ToCharArray())
                    Console.WriteLine("Supported cultures: {0}", str)
                End If
                Console.WriteLine("Default culture: {0}", web.UICulture.Name)
            End Using
        End Using
        Console.WriteLine(vbCrLf + "Press ENTER to continue....")
        Console.Read()
    End Sub
End Module