Creación de una aplicación cliente básica de SharePoint Foundation

Última modificación: martes, 03 de agosto de 2010

Hace referencia a: SharePoint Foundation 2010

Disponible en SharePoint Online

Para crear una aplicación cliente administrada de .NET que use el modelo de objetos cliente, se deben establecer referencias a dos archivos DLL de bibliotecas cliente: Microsoft.SharePoint.Client.dll y Microsoft.SharePoint.Client.Runtime.dll. Se pueden copiar estos DLL desde la carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI del servidor que ejecuta Microsoft SharePoint Foundation 2010 al equipo remoto en el que se crea la aplicación.

Creación de una aplicación de consola básica

En la siguiente tarea de programación se detallan los pasos necesarios del procedimiento para crear una aplicación de consola básica en Microsoft Visual Studio que use objetos en el espacio de nombres Microsoft.SharePoint.Client para devolver propiedades de sitio web.

1. En el menú Archivo, seleccione Nuevo y haga clic en Proyecto.

2. En el cuadro de diálogo Nuevo proyecto, seleccione Visual Basic o Visual C# en el panel Plantillas instaladas. Seleccione Windows y, a continuación, Aplicación de consola. Elija .NET Framework 3.5 de la lista desplegable de la parte superior del panel central. Escriba un nombre y una ubicación pera el proyecto en los cuadros Nombre y Ubicación. A continuación, haga clic en Aceptar.

3. En el Explorador de Windows, copie los dos archivos DLL de la carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI del servidor en la carpeta de nivel superior de la aplicación de consola.

4. Haga clic con el botón secundario en el proyecto en el Explorador de soluciones, haga clic en Agregar referencia y, en el cuadro de diálogo Agregar referencia, haga clic en la pestaña Explorar y busque la carpeta donde copió Microsoft.SharePoint.Client.dll y Microsoft.SharePoint.Client.Runtime.dll. Seleccione los archivos DLL y haga clic en Aceptar.

5. En el siguiente ejemplo se devuelve y se muestra el título del sitio web en la dirección URL que se especifica en el constructor ClientContext(). El método Load<T>(T, []) especifica qué objeto se debe recuperar del servidor, que en este caso es el sitio web, y ExecuteQuery() realiza la consulta. Debido a que se carga el objeto de sitio web, todas sus propiedades predeterminadas se vuelven disponibles para mostrarse en la consola. Para obtener información acerca de las propiedades que no están disponibles de manera predeterminada al cargar un objeto o una colección, vea Introducción a la recuperación de datos.

   using System;
   using Microsoft.SharePoint.Client;
   namespace Microsoft.SDK.SharePointServices.Samples
   {
       class DisplayWebTitle
       {
           static void Main()
           {
               ClientContext clientContext = new ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite");
               Web oWebsite = clientContext.Web;  
               clientContext.Load(oWebsite);
               clientContext.ExecuteQuery();
   
               Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created);
           }
       }
   }
   

   Imports System
   Imports Microsoft.SharePoint.Client
   
   Namespace Microsoft.SDK.SharePointServices.Samples
   
       Class DisplayWebTitle
   
           Public Overloads Shared Sub Main()
   
               Dim clientContext As New ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite")
               Dim oWebsite As Web = clientContext.Web
               clientContext.Load(oWebsite)
               clientContext.ExecuteQuery()
   
               Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created)
   
           End Sub
       End Class
   End Namespace
   

6. Presione F5 para ejecutar la aplicación y mostrar el título y fecha de creación del sitio web en la consola.

Vea también

Conceptos

Procedimiento para trabajar con sitios web

Introducción a la recuperación de datos

Tareas comunes de programación

Otros recursos

Biblioteca de clases de cliente

Biblioteca de clases de ECMAScript