Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GetListItem Method
Collapse the table of content
Expand the table of content

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)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online

public SPListItem GetListItem(
	string 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.


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.

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.
© 2015 Microsoft