ListItem classe

Representa um item ou linha em uma lista.

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.Client.ClientObject
    Microsoft.SharePoint.Client.SecurableObject
      Microsoft.SharePoint.Client.ListItem

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 Class ListItem _
    Inherits SecurableObject
'Uso
Dim instance As ListItem

public class ListItem : SecurableObject

Comentários

Contém campos de expando CSOM, que correspondem aos campos definidos na lista pai. O nome do campo de expando CSOM é o nome do campo definido na lista e o valor do campo de expando CSOM é o valor do campo no item da lista. A tabela a seguir define o mapeamento entre valores e tipos de campo.

Tipo de campo	Tipo de valor do campo de Expando CSOM	Significado
Integer	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM Int32.	Campo permite que um valor inteiro.
Texto	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Campo permite que uma cadeia de comprimento limitado de texto.
Observação	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Campo permite que grandes quantidades de texto.
DateTime	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM DateTime.	Campo permite que a data completa e valores de tempo, bem como valores somente Data.
Contador	Ele deve ser CSOM Int32.	Contador é um campo de número inteiro monotônica e tem um valor exclusivo em relação a outros valores que são armazenados para o campo na lista. Contador é usado somente para o campo de identificador de item de lista e não se destina para uso em outro lugar.
Escolha	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Campo permite a seleção de um conjunto de valores sugeridos. Um campo de escolha é compatível com uma configuração de nível de campo que especifica se há suporte para valores de forma livre.
Pesquisa	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM objeto.	Campo permite que uma referência a outro item de lista. O campo oferece suporte a especificação de um identificador de lista para uma lista de destino. Um identificador de site opcional também pode ser especificado, que especifica o site da lista que contém o destino de pesquisa.
Boolean	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.	Campo permite que um valor true ou false .
Número	Quando seu valor é indefinido deve ser CSOM nulo, caso contrário, ele deve estar CSOM duplo.	Campo permite que um número positivo ou negativo. Um campo número dá suporte à configuração nível um campo usada para especificar o número de casas decimais para exibir.
Moeda	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM duplo.	Campo permite que os dados relacionados a moeda. O campo de moeda tem uma propriedade CurrencyLocaleId que usa um identificador de localidade da moeda usar.
URL	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM objeto.	Campo permite uma URL e uma descrição opcional da URL.
Calculado	N/D	Campo processa saída com base no valor de outras colunas.
Threading	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Contém dados sobre o threading de itens em um quadro de discussão.
GUID	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM GUID.	Especifica que o valor do campo é um GUID.
MultiChoice	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM matriz.	Campo permite que um ou mais valores de um conjunto de opções especificadas. Um campo de várias opções também pode oferecer suporte a valores de forma livre.
GridChoice	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM matriz.	Opção de grade oferece suporte a especificação de várias escalas de número em uma lista.
Calculado	N/D	Valor do campo é calculado com base no valor de outras colunas.
Arquivo	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Especifica uma referência a um arquivo que pode ser usado para recuperar o conteúdo do arquivo.
Attachments	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.	Campo descreve se um ou mais arquivos são associados ao item. Consulte anexos para obter mais informações sobre anexos. true se um item de lista tem anexos e false se um item de lista não tem anexos.
User	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM objeto.	Uma pesquisa para um usuário específico na lista de informações do usuário.
Recorrência	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.	Especifica se um campo contém um padrão de recorrência de um item.
CrossProjectLink	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.	Campo permite que um link para um site de espaço de trabalho de reunião.
ModStat	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM int32.	Especifica o status atual de um processo de moderação no documento.
Erro	N/D	Especifica os erros. Valor = 24.
ContentTypeId	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM objeto.	Campo contém um identificador de tipo de conteúdo de um item. ContentTypeId segue a estrutura definida no ContentTypeId.
PageSeparator	N/D	Representa um espaço reservado para um separador de página em uma lista de pesquisa. PageSeparator destina-se somente a ser usado com uma lista de pesquisa.
ThreadIndex	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.	Contém um índice compilado de threads em um quadro de discussão.
WorkflowStatus	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM Int32.	Contém o status em um fluxo de trabalho em execução para um item específico.
AllDayEvent	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.	O campo AllDayEvent só é usado em conjunto com uma lista de eventos. true se o item for um evento de dia inteiro (ou seja, não ocorrer durante um conjunto específico de horas em um dia).
WorkflowEventType	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM Int32.	Uma descrição de um tipo de um evento de histórico do fluxo de trabalho. Consulte enumeração WorkflowEventType para obter mais informações.
Instalações	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM matriz.
FreeBusy	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.
Overbook	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.
Confidencial	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.
WhatsNew	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.
DueDate	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM DateTime.
AllowEditing	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM booliano.
SendTo	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM matriz
Confirmações	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.
CallTo	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM matriz.
CallTime	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM DateTime.
Whereabout	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.
De	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM DateTime.
Até	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, ele deve estar CSOM DateTime.
ContactInfo	Quando seu valor é indefinido deve ser CSOM uma referência nula (Nothing no Visual Basic), caso contrário, deve ser uma cadeia de CSOM.

Exemplos

Este exemplo de código adiciona um item à lista de anúncios no site especificado.

using System;
using Microsoft.SharePoint.Client;

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

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

            ListItemCreationInformation itemCreateInfo = new ListItemCreationInformation();
            ListItem newListItem = targetList.AddItem(itemCreateInfo);
            newListItem["Title"] = "New Announcement";
            newListItem["Body"] = "Hello World!";
            newListItem.Update();

            clientContext.Load(newListItem);
            clientContext.ExecuteQuery();

            Console.WriteLine("Announcement created! \n\n"
               + "ID: " + newListItem.Id + "\nTitle: " + newListItem["Title"]);
        }
    }
}

Segurança de thread

Os membros públicos estática (Shared no Visual Basic) desse tipo são seguros para thread. Nenhum membro de instância pode ser garantido como seguro para thread.

Ver também

Referência

ListItem membros

Microsoft.SharePoint.Client namespace