Introducción al modelo de objetos de perfiles de usuario

Microsoft Office SharePoint Server 2007 ofrece un completo modelo de objetos para manipular perfiles de usuario mediante programación. En este tema se resumen los cambios principales en el modelo de objetos para los usuarios de Microsoft Office SharePoint Portal Server 2003. Para obtener información acerca de procedimientos, consulte las secciones siguientes:

Configuración de almacén de perfiles de usuario mediante el modelo de objetos

Acceso al almacén de perfiles de usuario mediante el modelo de objetos

Uso del modelo de objetos de perfiles de usuario

En SharePoint Portal Server 2003, se usa el espacio de nombres Microsoft.SharePoint.Portal.UserProfiles para trabajar con el perfil de un usuario y con Mi sitio. No obstante, en Office SharePoint Server 2007, debe usar el espacio de nombres Microsoft.Office.Server.UserProfiles en Microsoft.Office.Server.dll. Este nuevo espacio de nombres proporciona compatibilidad con el modelo de objetos para los perfiles de usuario de Office SharePoint Server 2007. El espacio de nombres Microsoft.SharePoint.Portal.UserProfiles todavía existe por compatibilidad con versiones anteriores. Las aplicaciones y herramientas escritas en SharePoint Portal Server 2003 con el espacio de nombres Microsoft.SharePoint.Portal.UserProfiles todavía deberían funcionar en Office SharePoint Server 2007. No obstante, tenga en cuenta que es posible que no se comporten de la forma esperada, concretamente al usar las nuevas características de perfiles de usuario (para obtener más información acerca de estas características, consulte Novedades en perfiles de usuario e identificación de audiencias).

Por ejemplo, si usa las API de Microsoft.SharePoint.Portal.UserProfiles para obtener la colección de propiedades de perfiles de usuario de Office SharePoint Server 2007, devolverán sólo las propiedades con un único valor compatibles con SharePoint Portal Server 2003. Omitirán las nuevas propiedades con múltiples valores y las propiedades que tengan listas de opciones. Por tanto, si escribe aplicaciones nuevas o actualiza aplicaciones antiguas, debe usar el nuevo espacio de nombres Microsoft.Office.Server.UserProfiles de Microsoft.Office.Server.dll. Todas las clases del espacio de nombres Microsoft.SharePoint.Portal.UserProfiles han quedado obsoletas y recibirá una advertencia cada vez que use una clase o un método de ese espacio de nombres.

Importante

La información de referencia de acerca de las API del SDK de Office SharePoint Server 2007 es un trabajo en curso. Para obtener información de referencia acerca de las API, consulte el SDK de Microsoft Office SharePoint Portal Server 2003.

Obtención del objeto UserProfileManager en Office SharePoint Server 2007

Aunque la sintaxis que se usaba para obtener el objeto UserProfileManager en SharePoint Portal Server 2003 todavía funciona (por la compatibilidad con versiones anteriores), en esta sección se presenta la nueva forma de escribir código con el modelo de objetos de perfiles de usuario de Office SharePoint Server 2007.

Antes de ejecutar el código, reemplace servername con el nombre del servidor de Office SharePoint Server 2007.

using Microsoft.Office.Server;
using Microsoft.Office.Server.Administration;
using Microsoft.Office.Server.UserProfiles;
using Microsoft.SharePoint;

namespace AccountNameDump
{
    public class Program
    {
        public static void Main(string[] args)
        {
            try
            {
                using (SPSite site = new SPSite("https://servername"))
                {
                    ServerContext context = 
                        ServerContext.GetContext(site);
                    UserProfileManager profileManager = new 
                        UserProfileManager(context);
                    foreach (UserProfile profile in profileManager)
                    {
             Console.WriteLine(profile[PropertyConstants.AccountName]);
                    }
                }
            }
            catch (FileNotFoundException exception)
            {
                Console.WriteLine(exception.ToString());
            }
        }
    }
}

Vea también

Otros recursos

Configuración de almacén de perfiles de usuario mediante el modelo de objetos
Acceso al almacén de perfiles de usuario mediante el modelo de objetos