Класс SPList

Статья
05/13/2015

Представляет список на веб-сайт Microsoft SharePoint Foundation.

Иерархия наследования

System.Object
  Microsoft.SharePoint.SPSecurableObject
    Microsoft.SharePoint.SPList
      Microsoft.SharePoint.SPDocumentLibrary
      Microsoft.SharePoint.SPIssueList

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Class SPList _
    Inherits SPSecurableObject
'Применение
Dim instance As SPList

public class SPList : SPSecurableObject

Замечания

Список состоит из элементов строк и столбцов или полей, которые содержат данные. Свойство Items возвращает коллекцию элементов в списке, и свойство Fields возвращает коллекцию всех полей в списке. В целях повышения производительности рекомендуется использовать один из методов GetItem* Возвращает отфильтрованный набор элементов из списка.

Различные свойства SPList , свойства ParentList и других свойств и методов для классов в пространстве имен Microsoft.SharePoint возврата списка или коллекцию списков из определенного контекста. В противном случае свойство Lists класса либо SPWeb , либо SPList возвращает объект SPListCollection , представляющий либо коллекцию списков на сайте или коллекцию списков родительский список. Используйте индексатор, чтобы получить один список из коллекции. Например если коллекции присваивается переменной с именем collLists, используйтеindexcollLists[] в C# илиindexcollLists() того, где index — номер индекса из списка в семействе сайтов, отображаемое имя списка или идентификатор GUID списка.

Примеры

В следующем примере кода возвращаются и отображает элементы из указанного списка, где были созданы более 500 значений в поле «ProjectedValue». В примере предполагается существование страницы ASPX, которая содержит элемент управления label.

Этот пример требует директивы using (Imports в Visual Basic) для пространства имен Microsoft.SharePoint и Microsoft.SharePoint.Utilities .

Dim siteCollection As SPSite = SPContext.Current.Site
Try

    Dim list As SPList = siteCollection.AllWebs("Site_Name").Lists("List_Name")
    Dim query As New SPQuery()
    query.Query = "<Where><Gt><FieldRef Name='ProjectedValue'/>" + "<Value Type='Number'>500</Value></Gt></Where>"
    Dim listItems As SPListItemCollection = list.GetItems(query)
            
        Dim listItem As SPListItem
        For Each listItem In  listItems
            Label1.Text += "Item: " + SPHttpUtility.HtmlEncode(listItem("Title").ToString()) + 
            "::" + "Value: " + SPHttpUtility.HtmlEncode(listItem("Investment").ToString()) + 
            "::" + "Calculated: " + SPHttpUtility.HtmlEncode(listItem("ProjectedValue").ToString()) + "<BR>"
        Next listItem
Finally
    siteCollection.Dispose()
End Try

SPSite oSiteCollection = SPContext.Current.Site;
SPList oList = oSiteCollection.AllWebs["Site_Name"].Lists["List_Name"];

SPQuery oQuery = new SPQuery();
oQuery.Query = "<Where><Gt><FieldRef Name='ProjectedValue'/>" +
    "<Value Type='Number'>500</Value></Gt></Where>";
SPListItemCollection collListItems = oList.GetItems(oQuery);

foreach (SPListItem oListItem in collListItems)
{
    Label1.Text += "Item: " + 
        SPHttpUtility.HtmlEncode(oListItem["Title"].ToString()) + 
        "::" + "Value: " +   
        SPHttpUtility.HtmlEncode(oListItem["Investment"].ToString()) +
        "::" + "Calculated: " + 
        SPHttpUtility.HtmlEncode(oListItem["ProjectedValue"].ToString()) + 
        "<BR>";
    }
}

After instantiating an SPQuery object, the example uses Collaborative Application Markup Language (CAML) to define criteria for the query, which is passed as a parameter in the GetItems method. For information about CAML, see Схемы Collaborative Application Markup Language (CAML).

Примечание

For information about how to use Language-Integrated Query (LINQ) queries to retrieve list items in SharePoint Foundation, see Managing Data with LINQ to SharePoint.

Потокобезопасность

Любые общедоступные элементы static (Shared в Visual Basic) этого типа являются потокобезопасными. Не гарантируется, что любые элементы экземпляров потокобезопасны.

См. также

Справочные материалы

Элементы SPList

Пространство имен Microsoft.SharePoint

Поделиться через