Метод SPWeb.GetListItem

Статья
05/13/2015

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

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

Синтаксис

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

returnValue = instance.GetListItem(strUrl)

public SPListItem GetListItem(
    string strUrl
)

Параметры

strUrl
Тип: System.String

URL-адрес относительно сервера элемента списка, например "/sites/sitecollection/Shared Documents/MyDocument.docx"или абсолютный URL-адрес, например https://server/sites/sitecollection/Shared Documents/MyDocument.docx.

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

Тип: Microsoft.SharePoint.SPListItem
Элемент списка, связанного с указанным URL-адрес относительно сервера.

Исключения

Исключение	Условие
ArgumentNullException	strUrl — null .
DirectoryNotFoundException	URL-адрес не указан правильный путь.
FileNotFoundException	URL-адрес не указывает допустимого элемента списка.

Замечания

Этот метод возвращает null , если не удается найти элемент списка.

Примеры

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

Обратите внимание, что в этом примере предполагается существование семейства веб-сайтов с абсолютным URL-адресом https://localhost/sites/sitecollection и семейства веб-сайтов имеет веб-узел с именем subsite.

Imports System
Imports Microsoft.SharePoint

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

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

            ' Get the list item.
            Dim item As SPListItem = web.GetListItem(itemUrl)

            ' Print the file name.
            Console.WriteLine(item.File.Name)

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

               // Get the list item.
               SPListItem item = web.GetListItem(itemUrl);

               // Print the file name.
               Console.WriteLine(item.File.Name);
            }
         }
         Console.ReadLine();
      }
   }
}

См. также

Справочные материалы

SPWeb класс

Элементы SPWeb

Пространство имен Microsoft.SharePoint

Поделиться через