SPWeb.GetListItem method

Gets the list item that is associated with the specified server-relative URL.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in 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
    Type: System.String

    The server-relative URL of the list item, such as "/sites/sitecollection/Shared Documents/MyDocument.docx", or an absolute URL, such as http://server/sites/sitecollection/Shared Documents/MyDocument.docx.

Return value

Type: Microsoft.SharePoint.SPListItem
The list item associated with the specified server-relative URL.


Exception Condition

strUrl is null .


The URL does not specify a valid path.


The URL does not point to a valid list item.


This method returns null if the list item cannot be found.


The following example is a console application that retrieves a list item from a document library and then prints the name of the associated file to the console.

Note that the example assumes the existence of a site collection with an absolute URL of http://localhost/sites/sitecollection and that this site collection has a website named subsite.

Imports System
Imports Microsoft.SharePoint

Module ConsoleApp
   Sub Main()
      Using site As SPSite = New SPSite("http://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.

         End Using
      End Using
   End Sub
End Module
using System;
using Microsoft.SharePoint;

namespace Test
   class ConsoleApp
      static void Main(string[] args)
         using (SPSite site = new SPSite("http://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.

See also


SPWeb class

SPWeb members

Microsoft.SharePoint namespace