Objetos de cliente, objetos valor y propiedades escalares

Artículo
09/24/2014

Última modificación: jueves, 15 de julio de 2010

Hace referencia a: SharePoint Foundation 2010

Un objeto de cliente es cualquier objeto que hereda de la clase ClientObject (JavaScript: ClientObject). Para obtener acceso al modelo de objetos de SharePoint Foundation, puede devolver un objeto de cliente que represente una colección de sitios o sitio web mediante la propiedad Site (JavaScript: site) o Web (JavaScript: web) de la clase ClientContext (JavaScript: ClientContext). Posteriormente, podrá usar estos objetos para devolver objetos de cliente por medio de métodos o propiedades del objeto. Por ejemplo, la propiedad Lists (JavaScript: lists) de la clase Web (JavaScript: Web) devuelve las listas del sitio web, o el método GetItems(CamlQuery) (JavaScript: getItems(query)) de la clase List (JavaScript: List) devuelve los elementos de la lista. Al devolver objetos mediante estos miembros, los objetos de cliente no tendrán datos hasta que se realice la recuperación de datos en los objetos para obtener los datos asociados. Para obtener información acerca de la recuperación de datos, vea Introducción a la recuperación de datos.

Objetos valor

Un objeto valor es cualquier objeto que hereda de la clase ClientValueObject (JavaScript: ClientValueObject). Por ejemplo, ListItem (JavaScript: ListItem) es un objeto de cliente, pero FieldUrlValue (JavaScript: FieldUrlValue) y otros objetos valor de campo son objetos valor. Puede pensar en un objeto valor como una estructura o clase .NET cuyas referencias se calculan por valor, mientras que un objeto de cliente es una clase o estructura cuyas referencias se calculan por referencia. Los objetos valor tienen propiedades pero no métodos. SharePoint Foundation trata a todos los tipos primitivos, por ejemplo string o int, como objetos valor.

Propiedades escalares

Mientras que una propiedad del objeto devuelve un objeto de cliente, las propiedades del valor devuelven valores de propiedad asociados con un objeto de cliente. Por ejemplo, Title (JavaScript: title) es una propiedad del valor que contiene un valor escalar o de cadena, pero RootFolder (JavaScript: rootFolder) es una propiedad del objeto que devuelve una carpeta. Una propiedad escalar es toda propiedad que contiene uno de los tipos de valor .NET y que incluye cualquier clase derivada de ClientValueObject (JavaScript: ClientValueObject). A continuación se muestra una lista de las propiedades escalares.