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