Clase ListItem

Representa un elemento o una fila de una lista.

Jerarquía de la herencia

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

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

public class ListItem : SecurableObject

Comentarios

Contiene OMSC expandido campos, que corresponden a los campos definidos en la lista principal. El nombre del campo OMSC expandido es el nombre del campo definido en la lista y el valor del campo expandido OMSC es el valor del campo en el elemento de lista. La siguiente tabla define la asignación entre los tipos de campo y valores.

Tipo de campo	Tipo de valor de campo expandido de OMSC	Significado
Integer	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser Int32 OMSC.	Campo permite un valor entero.
Texto	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Campo permite una cadena de longitud limitada de texto.
Nota	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Campo permite grandes cantidades de texto.
DateTime	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC DateTime.	Campo permite la fecha completa y valores de hora, así como valores de fecha de solo lectura.
Counter	Debe ser Int32 OMSC.	Contador es un campo de tipo entero progresión y tiene un valor único en relación con otros valores que se almacenan en el campo de la lista. Contador se usa solamente para el campo de identificador del elemento de lista y no está pensado para su uso en otra aplicación.
Opción	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Campo permite la selección de un conjunto de valores sugeridos. Un campo de opción es compatible con una configuración de nivel de campo que especifica si se admiten los valores de forma libre.
Buscar	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser objeto de OMSC.	Campo permite una referencia a otro elemento de lista. El campo es compatible con la especificación de un identificador de la lista para una lista de destino. También se especifica un identificador de sitio opcional, que especifica el sitio de la lista que contiene el destino de la búsqueda.
Boolean	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.	Campo permite un valor true o false .
Número	Cuando el valor está definido debe ser OMSC null, en caso contrario, debe ser OMSC doble.	Campo permite a un número positivo o negativo. Un campo numérico es compatible con el campo nivel utilizada una configuración para especificar el número de posiciones decimales para mostrar.
Moneda	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC doble.	Campo permite para los datos de moneda. El campo de moneda tiene una propiedad CurrencyLocaleId que tiene un identificador de configuración regional de la moneda que desee usar.
Dirección URL	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser objeto de OMSC.	Campo permite una dirección URL y la descripción opcional de la dirección URL.
Calculado	N/A	Campo representa los resultados según el valor de otras columnas.
Subproceso	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Contiene datos sobre los subprocesos de los elementos de un panel de discusión.
Guid	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser CSOM GUID.	Especifica que el valor del campo es un GUID.
MultiChoice	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC matriz.	Campo permite uno o varios valores de un conjunto de opciones especificadas. Un campo de varias también admiten valores de forma libre.
GridChoice	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC matriz.	Opción de cuadrícula admite la especificación de varias escalas de número en una lista.
Calculado	N/A	Valor del campo se calcula según el valor de otras columnas.
Archivo	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Especifica una referencia a un archivo que se pueden usar para recuperar el contenido del archivo.
Datos adjuntos	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.	Campo describe si uno o más archivos están asociados con el elemento. Ver datos adjuntos para obtener más información sobre los datos adjuntos. true si un elemento de lista tiene datos adjuntos y false si un elemento de lista no tiene datos adjuntos.
User	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser objeto de OMSC.	Búsqueda de un usuario concreto en la lista de información de usuario.
Periodicidad	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.	Especifica si un campo contiene un patrón de periodicidad de un elemento.
CrossProjectLink	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.	Campo permite un vínculo a un sitio de área de reuniones.
ModStat	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser int32 OMSC.	Especifica el estado actual de un proceso de moderación en el documento.
Error	N/A	Especifica los errores. Valor = 24.
ContentTypeId	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser objeto de OMSC.	Campo contiene un identificador de tipo de contenido de un elemento. ContentTypeId se ajusta a la estructura definida en ContentTypeId.
PageSeparator	N/A	Representa un marcador de posición para un separador de página en una lista de encuesta. PageSeparator sólo está pensado para usarse con una lista de encuesta.
ThreadIndex	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.	Contiene un índice compilado de subprocesos en un panel de discusión.
WorkflowStatus	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser Int32 OMSC.	Contiene el estado de un flujo de trabajo de ejecución de un elemento en particular.
AllDayEvent	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.	El campo AllDayEvent solo se usa junto con una lista de eventos. true si el elemento es un evento de todo el día (es decir, no se produce durante un conjunto concreto de horas en un día).
WorkflowEventType	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser Int32 OMSC.	Una descripción de un tipo de un evento de flujo de trabajo históricos. Para obtener más información, vea WorkflowEventType enumeración.
Instalaciones	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC matriz.
FreeBusy	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.
Overbook	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.
Confidencial	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.
WhatsNew	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.
DueDate	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC DateTime.
AllowEditing	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC booleana.
SendTo	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser matriz OMSC
Confirmaciones	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.
CallTo	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC matriz.
CallTime	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC DateTime.
Whereabout	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.
De	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC DateTime.
Hasta	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC DateTime.
ContactInfo	Cuando el valor está definido debe ser OMSC una referencia null (Nothing en Visual Basic), en caso contrario, debe ser OMSC cadena.

Ejemplos

Este ejemplo de código agrega un elemento a la lista anuncios en el sitio 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"]);
        }
    }
}

Seguridad para subprocesos

Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.

Vea también

Referencia

Miembros ListItem

Espacio de nombres Microsoft.SharePoint.Client