SPWeb.GetListItem method

取得與指定的伺服器相對 URL 相關聯的清單項目。

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

Syntax

'宣告
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

  清單項目，例如"/sites/sitecollection/Shared Documents/MyDocument.docx"，伺服器相對 URL 或絕對 URL，例如https://server/sites/sitecollection/Shared Documents/MyDocument.docx。

傳回值

Type: Microsoft.SharePoint.SPListItem
指定的伺服器相對 URL 相關聯的清單項目。

Exceptions

Exception	Condition
ArgumentNullException	strUrl是 null 。
DirectoryNotFoundException	URL 未指定有效的路徑。
FileNotFoundException	URL 未指向有效的清單項目。

備註

如果找不到清單項目，這個方法會傳回 null 。

Examples

下列範例是主控台應用程式，從 [文件庫擷取清單項目，然後再列印到主控台相關檔案的名稱。

請注意此範例假設使用絕對 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 class

SPWeb members

Microsoft.SharePoint namespace