SPWeb.GetList-Methode

Artikel
05/06/2015

Ruft die Liste, die der angegebenen serverrelative URL zugeordnet ist.

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

Syntax

'Declaration
Public Function GetList ( _
    strUrl As String _
) As SPList
'Usage
Dim instance As SPWeb
Dim strUrl As String
Dim returnValue As SPList

returnValue = instance.GetList(strUrl)

public SPList GetList(
    string strUrl
)

Parameter

strUrl
Typ: System.String

Die serverrelative URL zum Stammordner der einer Liste, z. B. /sites/sitecollection/subsite/Lists/Announcements.

Rückgabewert

Typ: Microsoft.SharePoint.SPList
Die Liste an der angegebenen serverrelative URL.

Ausnahmen

Ausnahme	Bedingung
FileNotFoundException	Entweder die URL gibt keinen gültigen Pfad zu der Website, oder die Liste nicht in der Website vorhanden.
ArgumentException	Der Parameter strUrl ist ein Null -Verweis.

Hinweise

Wenn Sie diese Methode aufrufen über eine ungültige URL wird eine Ausnahme ausgelöst und der Wert der Eigenschaft AllowUnsafeUpdates auf falsefestgelegt ist.

Verwenden Sie die GetListFromWebPartPageUrl -Methode, um die Liste zurückzugeben, die das erste Webpart in einer Webpartseite zugeordnet ist.

Beispiele

Im folgende Beispiel wird eine Konsolenanwendung, die veranschaulicht, wie ein SPList -Objekt abzurufen, das die Ankündigungsliste auf einer Website darstellt.

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("sitecollection/subsite")

            Dim listUrl As String = "/sites/sitecollection/subsite/Lists/Announcements"
            Dim list As SPList = web.GetList(listUrl)
            Console.WriteLine("List URL: {0}", list.RootFolder.ServerRelativeUrl)

         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("sitecollection/subsite"))
            {
               string listUrl = "/sites/sitecollection/subsite/Lists/Announcements";
               SPList list = web.GetList(listUrl);
               Console.WriteLine("List URL: {0}", list.RootFolder.ServerRelativeUrl);
            }
         }
         Console.ReadLine();
      }
   }
}