List.GetItems método

Artigo
05/11/2016

Retorna uma coleção de itens da lista com base na consulta especificada.

Namespace: Microsoft.SharePoint.Client
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)

Sintaxe

'Declaração
Public Function GetItems ( _
    query As CamlQuery _
) As ListItemCollection
'Uso
Dim instance As List
Dim query As CamlQuery
Dim returnValue As ListItemCollection

returnValue = instance.GetItems(query)

public ListItemCollection GetItems(
    CamlQuery query
)

Parâmetros

query
Tipo: Microsoft.SharePoint.Client.CamlQuery

Um objeto de CamlQuery que contém a consulta.

Valor retornado

Tipo: Microsoft.SharePoint.Client.ListItemCollection
Um objeto de ListItemCollection que representa os itens.

Exceções

Exceção	Condição
SPException	O campo especificado na consulta não está presente na lista. Código de erro:-2130575340.
SPQueryThrottledException	O limite de otimização foi excedido pela operação. Código de erro:-2147024860.Or lá é uma falta de recursos disponíveis para processar a solicitação. Código de erro:-2147024749.
UnauthorizedAccessException	O usuário tem permissões suficientes para executar a operação. Código de erro: -2147024891.

Comentários

Ele não deve ser uma referência nula (Nothing no Visual Basic).

Exemplos

Este exemplo de código obtém anúncios no site atual que contêm a cadeia especificada.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class List_getItemsExample
    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;
            List targetList = site.Lists.GetByTitle("Announcements");

            CamlQuery query = new CamlQuery();
            query.ViewXml = "<View><Query><Where><Contains><FieldRef Name='Title'/><Value Type='Text'>announce</Value></Contains></Where></Query></View>";
            ListItemCollection collListItem = targetList.GetItems(query);

            clientContext.Load(collListItem);
            clientContext.ExecuteQuery();

            if (collListItem.Count == 0)
            {
               Console.WriteLine("No items containing 'announce' found.");
            }
            else
            {
               Console.WriteLine("Items containing 'announce' found:\n");
               foreach (ListItem targetListItem in collListItem)
                  Console.WriteLine(targetListItem["Title"]);
            }
        }
    }
}

Ver também

Referência

List classe

List membros

Microsoft.SharePoint.Client namespace

Compartilhar via