List.GetItemById método (Int32)
Retorna o item de lista com o identificador de item de lista especificado.
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 GetItemById ( _
id As Integer _
) As ListItem
'Uso
Dim instance As List
Dim id As Integer
Dim returnValue As ListItem
returnValue = instance.GetItemById(id)
public ListItem GetItemById(
int id
)
Parâmetros
id
Tipo: System.Int32Especifica o identificador de item de lista.
Valor retornado
Tipo: Microsoft.SharePoint.Client.ListItem
Retorna um ListItem que representa o item de lista com o identificador de item de lista especificada.
Exceções
| Exceção | Condição |
|---|---|
| [System.ArgumentException] | Item de lista não existe. Código de erro: -2147024809. |
| [System.UnauthorizedAccessException] | O usuário atual tem permissões suficientes. Código de erro: -2147024891. |
Exemplos
Este exemplo de código obtém um item de lista com um identificador especificado.
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class List_getItemByIdExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
List targetList = site.Lists.GetByTitle("Announcements");
// Get the list item from the Announcements list whose Id is 4.
// Note that this is the ID of the item in the list, not a reference to its position.
ListItem targetListItem = targetList.GetItemById(4);
// Load only the title.
clientContext.Load(targetListItem,
item => item["Title"]);
clientContext.ExecuteQuery();
Console.WriteLine("Request succeeded. \n\n");
Console.WriteLine("Retrieved item is: {0}", targetListItem["Title"]);
}
}
}