Partager via


SPWeb.GetListItem - Méthode

Obtient l'élément de liste qui est associé à l'URL relative de serveur spécifiée.

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Function GetListItem ( _
    strUrl As String _
) As SPListItem
'Utilisation
Dim instance As SPWeb
Dim strUrl As String
Dim returnValue As SPListItem

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

Paramètres

  • strUrl
    Type : System.String

    L'URL relative de serveur de l'élément de liste, tels que "/sites/sitecollection/Shared Documents/MyDocument.docx", ou une URL absolue, par exemple https://server/sites/sitecollection/Shared Documents/MyDocument.docx.

Valeur renvoyée

Type : Microsoft.SharePoint.SPListItem
L'élément de liste associé à l'URL relative de serveur spécifiée.

Exceptions

Exception Condition
ArgumentNullException

strUrl est null .

DirectoryNotFoundException

L'URL ne spécifie pas un chemin valide.

FileNotFoundException

L'URL ne pointe pas vers un élément de liste valide.

Remarques

Cette méthode retourne null si l'élément de liste ne peut pas être trouvé.

Exemples

L'exemple suivant est une application console qui récupère un élément de liste à partir d'une bibliothèque de documents, puis imprime le nom du fichier associé à la console.

Notez que l'exemple suppose l'existence d'une collection de sites avec une URL absolue de https://localhost/sites/sitecollection et que cette collection de sites possède un site Web nommé 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();
      }
   }
}

Voir aussi

Référence

SPWeb classe

SPWeb - Membres

Microsoft.SharePoint - Espace de noms