Compartir a través de


del método SPWeb.GetListItem

Obtiene el elemento de lista que está asociado con la dirección URL relativa al servidor especificada.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Function GetListItem ( _
    strUrl As String _
) As SPListItem
'Uso
Dim instance As SPWeb
Dim strUrl As String
Dim returnValue As SPListItem

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

Parámetros

  • strUrl
    Tipo: System.String

    La dirección de URL relativa al servidor del elemento de lista, como "/sites/sitecollection/Shared Documents/MyDocument.docx", o una dirección URL absoluta, como https://server/sites/sitecollection/Shared Documents/MyDocument.docx.

Valor devuelto

Tipo: Microsoft.SharePoint.SPListItem
El elemento de lista asociado a la dirección URL relativa al servidor especificada.

Excepciones

Excepción Condición
ArgumentNullException

strUrl es nulo .

DirectoryNotFoundException

La dirección URL no especifica una ruta de acceso válida.

FileNotFoundException

La dirección URL no señala a un elemento de lista válido.

Comentarios

Este método devuelve nulo si no se encuentra el elemento de lista.

Ejemplos

En el siguiente ejemplo es una aplicación de consola que recupera un elemento de lista de una biblioteca de documentos y, a continuación, se imprime el nombre del archivo asociado a la consola.

Tenga en cuenta que el ejemplo supone la existencia de una colección de sitios con una dirección URL absoluta de https://localhost/sites/sitecollection y que esta colección de sitios tiene un sitio Web denominado 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();
      }
   }
}

Vea también

Referencia

clase SPWeb

Miembros SPWeb

Espacio de nombres Microsoft.SharePoint