Класс SPQuery

Статья
05/13/2015

Представляет запрос в представлении списка.

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

System.Object
Microsoft.SharePoint.SPQuery

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

Синтаксис

'Декларация
Public Class SPQuery
'Применение
Dim instance As SPQuery

public class SPQuery

Замечания

Атрибут Type является особенно удобным для полей подстановки и пользователей. В противном случае без этого атрибута запроса не может возвращать ожидаемые результаты. В некоторых случаях запрос может не полностью.

Сведения об использовании запросов, встроенных в язык запросов (LINQ) для извлечения элементов списка в SharePoint FoundationManaging Data with LINQ to SharePointсм.

Примеры

В следующем примере кода отображаются заголовки элементов в список задач, где столбец состояние равно завершено. В примере используется Язык разметки совместной работы приложений (CAML) для определения запроса.

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

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Dim list As SPList = webSite.Lists("Tasks")

Dim query As New SPQuery()
query.Query = "<Where><Eq><FieldRef Name='Status'/>" + _
  "<Value Type='Text'>Completed</Value></Eq></Where>"
Dim items As SPListItemCollection = list.GetItems(query)

Dim item As SPListItem
For Each item In  items
    Response.Write((SPEncode.HtmlEncode(item("Title").ToString()) + _
      "<BR>"))
Next item

SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb
SPList oList = oWebsiteRoot.Lists["Tasks"];

SPQuery oQuery = new SPQuery();
oQuery.Query = "<Where><Eq><FieldRef Name='Status'/>" +
    "<Value Type='Text'>Completed</Value></Eq></Where>";
SPListItemCollection collListItems = oList.GetItems(oQuery);

foreach (SPListItem oListItem in collListItems)
{
    Response.Write(SPEncode.HtmlEncode(oListItem["Title"].ToString()) + 
        "<BR>");
}

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

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

См. также

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

Элементы SPQuery

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

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