Класс SPList
Представляет список на веб-сайт 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) этого типа являются потокобезопасными. Не гарантируется, что любые элементы экземпляров потокобезопасны.