del método List.GetItems
Devuelve una colección de elementos de la lista en función de la consulta especificada.
Espacio de nombres: Microsoft.SharePoint.Client
Ensamblados: Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)
Sintaxis
'Declaración
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.CamlQueryObjeto CamlQuery que contiene la consulta.
Valor devuelto
Tipo: Microsoft.SharePoint.Client.ListItemCollection
Objeto ListItemCollection que representa los elementos.
Excepciones
Excepción | Condición |
---|---|
SPException | El campo especificado en la consulta no está presente en la lista. Código de error:-2130575340. |
SPQueryThrottledException | El límite se ha superado la operación. Código de error:-2147024860.Or allí es una falta de recursos disponibles para procesar la solicitud. Código de error:-2147024749. |
UnauthorizedAccessException | El usuario tiene permisos suficientes para realizar la operación. Código de error: -2147024891. |
Comentarios
No debe ser una referencia null (Nothing en Visual Basic).
Ejemplos
En este ejemplo, se obtiene anuncios del sitio actual que contengan la cadena 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"]);
}
}
}
}