SPWeb.GetListItem-Methode

Ruft ab, das Listenelement, das der angegebenen serverrelative URL zugeordnet ist.

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

Syntax

'Declaration
Public Function GetListItem ( _
    strUrl As String _
) As SPListItem
'Usage
Dim instance As SPWeb
Dim strUrl As String
Dim returnValue As SPListItem

returnValue = instance.GetListItem(strUrl)
public SPListItem GetListItem(
    string strUrl
)

Parameter

  • strUrl
    Typ: System.String

    Die serverrelative URL des Listenelements, wie "/sites/sitecollection/Shared Documents/MyDocument.docx", oder eine absolute URL, z. B. https://server/sites/sitecollection/Shared Documents/MyDocument.docx.

Rückgabewert

Typ: Microsoft.SharePoint.SPListItem
Das Listenelement, die der angegebenen serverrelative URL zugeordnet.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

strUrl ist Null .

DirectoryNotFoundException

Die URL gibt kein gültiger Pfad an.

FileNotFoundException

Die URL verweist nicht auf einen gültigen Listenelement.

Hinweise

Diese Methode gibt Null zurück, wenn das Listenelement nicht gefunden werden kann.

Beispiele

Im folgende Beispiel wird eine Konsolenanwendung, die ein Listenelement aus einer Dokumentbibliothek abgerufen und dann wird der Name der zugehörigen-Datei in der Konsole angezeigt.

Beachten Sie, dass das Vorhandensein einer Websitesammlung mit einer absoluten URL der https://localhost/sites/sitecollection angenommen und dieser Websitesammlung eine Website mit dem Namen subsiteist.

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();
      }
   }
}

Siehe auch

Referenz

SPWeb Klasse

SPWeb-Member

Microsoft.SharePoint-Namespace